ചുരുക്കത്തിൽ: ഒരു ഏജൻസി സ്വന്തം നിയമപരമായ പേരിൽ ഒരിക്കൽ രജിസ്റ്റർ ചെയ്യുന്നു; തുടർന്ന് ഓരോ ക്ലയന്റിന്റെയും പേര് അംഗങ്ങൾക്ക് കാണിക്കുന്ന പേര് എന്നതിൽ നൽകി ക്ലയന്റുകൾക്കായി പരസ്യം ചെയ്യുന്നു. പണം നൽകുന്നതും ബാലൻസുകൾ കൈവശം വയ്ക്കുന്നതും ഇൻവോയ്സുകൾ സ്വീകരിക്കുന്നതും ഏജൻസിയാണ്. പരസ്യ പോർട്ടലിൽ നിന്നുള്ള API കീകൾ ഉപയോഗിച്ച് Agilis REST API (https://ads.agilis.dating) വഴി ഡെവലപ്പർമാർക്ക് ഓഫറുകളും പരിപാടികളും സൃഷ്ടിക്കാനും കൈകാര്യം ചെയ്യാനും കഴിയും; പരീക്ഷണ കീകൾ സൗജന്യമാണ്, അവ ഉപയോഗിച്ച് സൃഷ്ടിക്കുന്നവ അംഗങ്ങൾക്ക് ഒരിക്കലും കാണിക്കില്ല.
ഏജൻസികൾക്ക്
- ഏജൻസിയുടെ സ്വന്തം നിയമപരമായ പേരിൽ ഏജൻസി രജിസ്റ്റർ ചെയ്യുക. → രജിസ്റ്റർ ചെയ്യുന്നത് എങ്ങനെ
- ഒരു ഓഫറോ പരിപാടിയോ സൃഷ്ടിക്കുമ്പോൾ, അംഗങ്ങൾക്ക് കാണിക്കുന്ന പേര് എന്നതിൽ നിങ്ങളുടെ അംഗങ്ങൾക്ക് കാണിക്കുന്ന പേര് നൽകുക. അംഗങ്ങൾ കാണുന്നത് ക്ലയന്റിന്റെ പേരാണ്, നിങ്ങളുടേതല്ല.
- ഓരോ ക്ലയന്റിനും വേണ്ടി പരസ്യം ചെയ്യാൻ അവരുടെ അനുമതി നിങ്ങൾക്ക് ഉണ്ടായിരിക്കണം. പരസ്യ നിബന്ധനകൾ പ്രകാരം ഇതിന്റെ ഉത്തരവാദിത്തം ഏജൻസിക്കാണ്.
ആര് പണം നൽകുന്നു, ആർക്ക് ഇൻവോയ്സ് ലഭിക്കുന്നു
- നിങ്ങളുടെ ഏജൻസിയുടെ അക്കൗണ്ടാണ് പണം നൽകുന്നത്, ഏജൻസിയുടെ ബില്ലിംഗ് കറൻസിയിൽ.
- നിങ്ങളുടെ ഏജൻസിയിലെ ഓരോ വ്യക്തിക്കും സ്വന്തം ബാലൻസ് ഉണ്ട്, അതിൽ നിന്നാണ് അവർ പണം നൽകുന്നത്. സ്ഥാപന ബാലൻസ് ഇവയുടെ ആകെത്തുകയാണ്. → ബാലൻസുകൾ എങ്ങനെ പ്രവർത്തിക്കുന്നു
- ഇൻവോയ്സുകളും ഫലങ്ങളും നിങ്ങളുടെ ഏജൻസിയുടെ പേരിലാണ്, ഓരോ പേയ്മെന്റിനും ഒരു ഇൻവോയ്സ് വീതം; അതിനാൽ ഓരോ ക്ലയന്റിനും നിങ്ങൾക്ക് വീണ്ടും ബിൽ ചെയ്യാം.
- ഓരോ ക്ലയന്റിന്റെയും ചെലവ് വേറിട്ട് സൂക്ഷിക്കാൻ, ഓരോ ക്ലയന്റിനും ഓരോ ഓഫറോ പരിപാടിയോ ഉപയോഗിക്കുക, അതിന്റെ ഇൻവോയ്സിൽ നിന്ന് വീണ്ടും ബിൽ ചെയ്യുക.
ടീം റോളുകൾ
സ്ഥാപന അഡ്മിൻമാരും പരസ്യദാതാക്കളും പരസ്യ പോർട്ടലിൽ പ്രവർത്തിക്കുന്നു; ഡെവലപ്പർമാർ API വഴി പ്രവർത്തിക്കുന്നു. ഡെവലപ്പർമാർക്ക് പരസ്യ പോർട്ടലിൽ ഓഫറുകളോ പരിപാടികളോ സൃഷ്ടിക്കാൻ കഴിയില്ല, എന്നാൽ അവരുടെ API കീകൾ ഉപയോഗിച്ച് API വഴി അവ സൃഷ്ടിക്കാനും പ്രസിദ്ധീകരിക്കാനും അവയ്ക്ക് പണം നൽകാനും കഴിയും. സ്ഥാപനത്തിന്റെ കീകൾ എങ്ങനെ ഉപയോഗിക്കുന്നു എന്നതിന്റെ ഉത്തരവാദിത്തം നിങ്ങളുടെ സ്ഥാപനത്തിനാണ്. പൂർണ്ണ പട്ടിക ടീം റോളുകളും അനുമതികളും എന്നതിൽ കാണാം.
Agilis REST API
- അടിസ്ഥാന URL: https://ads.agilis.dating
- റഫറൻസ്: www.agilis.dating/api-doc, cURL, Python, Node.js, PHP എന്നിവയിലെ ഉദാഹരണങ്ങളും ഒരു API സഹായിയും സഹിതം
- യന്ത്രങ്ങൾക്ക് വായിക്കാവുന്നവ: OpenAPI 3.1 www.agilis.dating/openapi.json എന്നതിൽ, Markdown www.agilis.dating/api-doc.md എന്നതിൽ, AI ഉപകരണങ്ങൾക്കുള്ള പൂർണ്ണ ടെക്സ്റ്റ് www.agilis.dating/llms-full.txt എന്നതിൽ
- ഓഫറുകൾ: നിങ്ങളുടെ വിഭാഗങ്ങളും താൽപ്പര്യങ്ങളും ലിസ്റ്റ് ചെയ്യുക; ഓഫർ സൃഷ്ടിക്കുന്നതിന് മുമ്പ് അതിന്റെ വില കണക്കാക്കുക; ഓഫറുകൾ സൃഷ്ടിക്കുക, ലിസ്റ്റ് ചെയ്യുക, താൽക്കാലികമായി നിർത്തുക, പുനരാരംഭിക്കുക, ഇല്ലാതാക്കുക; ഓരോ ഓഫറിന്റെയും ഫലങ്ങൾ വായിക്കുക
- പരിപാടികൾ: പരിപാടികൾ പ്രിവ്യൂ ചെയ്യുക, പ്രസിദ്ധീകരിക്കുക, ലിസ്റ്റ് ചെയ്യുക, എഡിറ്റ് ചെയ്യുക, പുനഃക്രമീകരിക്കുക, റദ്ദാക്കുക, ഇല്ലാതാക്കുക; ഓരോ പരിപാടിയുടെയും ഫലങ്ങൾ വായിക്കുക
ഒരു API കീ നേടുക
- സ്ഥാപന അഡ്മിൻ അല്ലെങ്കിൽ ഡെവലപ്പർ ആയി പരസ്യ പോർട്ടലിൽ സൈൻ ഇൻ ചെയ്യുക.
- പേജിന്റെ മുകളിലുള്ള സ്വിച്ച് ഉപയോഗിച്ച് പരീക്ഷണ മോഡ് അല്ലെങ്കിൽ തത്സമയ മോഡ് തിരഞ്ഞെടുക്കുക.
- API കീകൾ → പുതിയ കീ സൃഷ്ടിക്കുക എന്നതിലേക്ക് പോകുക, കീയ്ക്ക് ഒരു പേരും ആവശ്യമെങ്കിൽ ഒരു കാലാവധി തീയതിയും നൽകുക.
- കീ ഉടൻ തന്നെ പകർത്തുക. പിന്നീട് അത് വീണ്ടും കാണാൻ കഴിയില്ല.
പരീക്ഷണ കീകൾ pk_test_ എന്ന് തുടങ്ങുന്നു; തത്സമയ കീകൾ pk_live_ എന്ന് തുടങ്ങുന്നു. ഓരോ വ്യക്തിക്കും ഓരോ മോഡിലും 10 കീകൾ വരെ ഉണ്ടാകാം. കീ പുതുക്കുക ഒരു കീയെ ഉടനടി മാറ്റിസ്ഥാപിക്കുന്നു, അതിനാൽ ആദ്യം നിങ്ങളുടെ സിസ്റ്റങ്ങൾ അപ്ഡേറ്റ് ചെയ്യുക. കീ x-api-key അഭ്യർത്ഥന ഹെഡറിൽ അയയ്ക്കുക: x-api-key: pk_test_….
സുരക്ഷിതമായി നിർമ്മിക്കുക
pk_test_കീ ഉപയോഗിച്ച് നിർമ്മിക്കുകയും പരീക്ഷിക്കുകയും ചെയ്യുക: പരീക്ഷണ ഓഫറുകളും പരിപാടികളും സൗജന്യമാണ്, അവ അംഗങ്ങൾക്ക് ഒരിക്കലും കാണിക്കില്ല.- ഒരു ഓഫർ സൃഷ്ടിക്കുന്നതിന് മുമ്പ്, വില കണക്കാക്കൽ (price-estimate) എൻഡ്‌പോയിന്റ് ഉപയോഗിച്ച് അതിന്റെ വില അറിയുക.
- കീകൾ കോഡ് റിപ്പോസിറ്ററികളിലും ബ്രൗസറുകളിലും വയ്ക്കരുത്; നിങ്ങളുടെ സെർവറിൽ നിന്ന് API വിളിക്കുക.
ചോദ്യങ്ങൾ
ഒരു ഏജൻസിക്ക് ഒരു അക്കൗണ്ടിൽ നിന്ന് ഒന്നിലധികം ക്ലയന്റുകളെ കൈകാര്യം ചെയ്യാനാകുമോ?
അതെ. ഏജൻസി ഒരിക്കൽ രജിസ്റ്റർ ചെയ്യുക, ഓരോ ഓഫറിലും പരിപാടിയിലും ക്ലയന്റിന്റെ പേര് നൽകുക.
ഓരോ ക്ലയന്റിനും പ്രത്യേകം ഇൻവോയ്സ് ലഭിക്കുമോ?
ഇൻവോയ്സുകൾ നിങ്ങളുടെ ഏജൻസിക്കാണ് നൽകുന്നത്, ഓരോ പേയ്മെന്റിനും ഒന്ന് വീതം. അവ ഉപയോഗിച്ച് നിങ്ങളുടെ ക്ലയന്റുകൾക്ക് വീണ്ടും ബിൽ ചെയ്യുക.
സാൻഡ്ബോക്സ് ഉണ്ടോ?
അതെ. pk_test_ കീകളോടുകൂടിയ പരീക്ഷണ മോഡ് ഒരു പൂർണ്ണ സാൻഡ്ബോക്സാണ്. ഒന്നിനും പണം ഈടാക്കില്ല, ഒന്നും അംഗങ്ങൾക്ക് കാണിക്കുകയുമില്ല.
AI കോഡിംഗ് ഉപകരണങ്ങൾ ബന്ധിപ്പിക്കാമോ?
അതെ. നിങ്ങളുടെ ഉപകരണത്തിന് www.agilis.dating/api-doc.md അല്ലെങ്കിൽ www.agilis.dating/openapi.json നൽകുക.
