Wakala, timu na API

Kwa ufupi: wakala hujisajili mara moja, kwa jina lake rasmi la kisheria, na hutangaza kwa niaba ya wateja wake kwa kuandika jina la kila mteja katika Jina linaloonyeshwa kwa wanachama. Wakala hulipa, hushikilia salio na hupokea ankara. Wasanidi wanaweza kuunda na kusimamia ofa na matukio kupitia REST API ya Agilis (https://ads.agilis.dating) kwa funguo za API kutoka Lango la Watangazaji; funguo za majaribio ni bure na kamwe hazionyeshwi kwa wanachama.

Kwa wakala

1. Sajili wakala kwa jina lake rasmi la kisheria. → Jinsi ya kujisajili
2. Unapounda ofa au tukio, andika jina la mteja wako katika Jina linaloonyeshwa kwa wanachama. Wanachama huona jina la mteja, si lako.
3. Lazima uwe umeidhinishwa na kila mteja kutangaza kwa niaba yake. Masharti ya Utangazaji yanaweka jukumu hili kwa wakala.

Nani hulipa, na nani hupokea ankara

• Akaunti ya wakala wako ndiyo hulipa, kwa sarafu ya malipo ya wakala wako.
• Kila mtu katika wakala wako ana salio lake na hulipa kutoka humo. Salio la shirika ndilo jumla. → Jinsi salio linavyofanya kazi
• Ankara na matokeo huwa kwa jina la wakala wako, ankara moja kwa kila malipo, ili uweze kumtoza tena kila mteja.
• Ili kutenganisha matumizi ya kila mteja, tumia ofa au tukio moja kwa kila mteja na umtoze tena kutokana na ankara yake.

Majukumu ya timu

Wasimamizi wa Shirika na Watangazaji hufanya kazi katika Lango la Watangazaji; Wasanidi hufanya kazi kupitia API. Wasanidi hawawezi kuunda ofa au matukio katika Lango la Watangazaji, lakini kwa funguo zao za API wanaweza kuziunda, kuzichapisha na kuzilipia kupitia API, na biashara yako inawajibika kwa jinsi funguo zake zinavyotumiwa. Jedwali kamili liko katika Majukumu na ruhusa za timu.

REST API ya Agilis

• URL ya msingi: https://ads.agilis.dating
• Marejeleo: www.agilis.dating/api-doc, pamoja na mifano katika cURL, Python, Node.js na PHP, na msaidizi wa API
• Zinazosomeka na mashine: OpenAPI 3.1 kwenye www.agilis.dating/openapi.json, Markdown kwenye www.agilis.dating/api-doc.md, na maandishi kamili kwa zana za AI kwenye www.agilis.dating/llms-full.txt
• Ofa: orodhesha kategoria zako na mambo yanayowavutia wanachama; kadiria bei ya ofa kabla ya kuiunda; unda, orodhesha, sitisha, endeleza na futa ofa; soma matokeo ya kila ofa
• Matukio: angalia onyesho la awali, chapisha, orodhesha, hariri, panga upya, ghairi na futa matukio; soma matokeo ya kila tukio

Pata ufunguo wa API

1. Ingia katika Lango la Watangazaji kama Msimamizi wa Shirika au Msanidi.
2. Chagua Hali ya Majaribio au Hali Halisi kwa kitufe cha kubadili kilicho juu ya ukurasa.
3. Nenda kwenye Funguo za API → Unda ufunguo mpya, upe jina na, ukipenda, tarehe ya kuisha muda.
4. Nakili ufunguo mara moja. Hutaweza kuuona tena.

Funguo za majaribio huanza na pk_test_; funguo halisi huanza na pk_live_. Kila mtu anaweza kuwa na hadi funguo 10 katika kila hali. Badilisha hubadilisha ufunguo papo hapo, kwa hiyo sasisha mifumo yako kwanza. Tuma ufunguo katika kichwa cha ombi x-api-key: x-api-key: pk_test_….

Unda kwa usalama

• Unda na ujaribu kwa ufunguo wa pk_test_: ofa na matukio ya majaribio ni bure na kamwe hayaonyeshwi kwa wanachama.
• Kadiria bei ya ofa kwa kituo cha API cha makadirio ya bei kabla ya kuiunda.
• Weka funguo mbali na hazina za msimbo na vivinjari; ita API kutoka kwenye seva yako.

Maswali

Je, wakala anaweza kusimamia wateja kadhaa kutoka akaunti moja?

Ndiyo. Sajili wakala mara moja na utaje jina la mteja kwenye kila ofa au tukio.

Je, kila mteja anaweza kuwa na ankara yake?

Ankara hutolewa kwa wakala wako, moja kwa kila malipo. Watoze wateja wako tena kutokana nazo.

Je, kuna mazingira ya majaribio (sandbox)?

Ndiyo. Hali ya Majaribio, kwa funguo za pk_test_, ni mazingira kamili ya majaribio. Hakuna kinachotozwa na hakuna kinachoonyeshwa kwa wanachama.

Je, ninaweza kuunganisha zana za AI za kuandika msimbo?

Ndiyo. Elekeza zana yako kwenye www.agilis.dating/api-doc.md au www.agilis.dating/openapi.json.