# Mga ahensya, team at ang API

Paano nag-a-advertise ang mga ahensya sa Agilis sa pangalan ng bawat kliyente, paano gumagana ang mga tungkulin, balanse at invoice, at ang Agilis REST API.

**Sa madaling sabi:** isang beses lang nagpaparehistro ang ahensya, sa sarili nitong legal na pangalan. Pagkatapos, nag-a-advertise ito para sa mga kliyente nito sa pamamagitan ng paglalagay ng pangalan ng bawat kliyente sa **Pangalang makikita ng mga miyembro**. Ang ahensya ang nagbabayad, may hawak ng mga balanse at tumatanggap ng mga invoice. Maaaring gumawa at mamahala ang mga Developer ng mga Offer at kaganapan sa pamamagitan ng **Agilis REST API** (https://ads.agilis.dating) gamit ang mga API key mula sa Ad Portal. Libre ang mga test key at hindi kailanman ipinapakita sa mga miyembro ang ginagawa gamit ang mga ito.

## Para sa mga ahensya

1. **Iparehistro ang ahensya** sa sarili nitong legal na pangalan. → [Paano magparehistro](https://www.agilis.dating/tl/business/guide/register)
2. Kapag gumagawa kayo ng Offer o kaganapan, ilagay ang **pangalan ng inyong kliyente** sa **Pangalang makikita ng mga miyembro**. Pangalan ng kliyente ang makikita ng mga miyembro, hindi ang pangalan ninyo.
3. Kailangang may pahintulot kayo mula sa bawat kliyente para mag-advertise para sa kanila. Ayon sa Mga Tuntunin sa Advertising, pananagutan ito ng ahensya.

**Sino ang nagbabayad, at kanino ipinapadala ang invoice**

- Ang account ng inyong ahensya ang nagbabayad, sa currency na ginagamit ng inyong ahensya sa pagsingil.
- May sariling balanse ang bawat tao sa inyong ahensya, at mula rito sila nagbabayad. Ang Balanse ng organisasyon ang kabuuan ng mga ito. → [Paano gumagana ang mga balanse](https://www.agilis.dating/tl/business/guide/pricing)
- Nasa pangalan ng inyong ahensya ang mga invoice at resulta, isang invoice bawat bayad, kaya masisingil ninyo muli ang bawat kliyente.
- Para mapanatiling hiwalay ang gastos ng bawat kliyente, gumamit ng isang Offer o kaganapan bawat kliyente, at singilin muli ang kliyente batay sa invoice nito.

## Mga tungkulin sa team

Sa Ad Portal nagtatrabaho ang mga Admin ng Organisasyon at Advertiser, habang sa API naman nagtatrabaho ang mga Developer. Hindi makakagawa ang mga Developer ng mga Offer o kaganapan sa Ad Portal. Pero gamit ang kanilang mga API key, makakagawa, makakapag-publish at makakapagbayad sila para sa mga ito sa pamamagitan ng API, at pananagutan ng inyong negosyo kung paano ginagamit ang mga key nito. Nasa [Mga tungkulin at pahintulot sa team](https://www.agilis.dating/tl/business/guide/getting-started) ang buong talahanayan.

## Ang Agilis REST API

- **Base URL:** https://ads.agilis.dating
- **Sanggunian:** www.agilis.dating/api-doc, may mga halimbawa sa cURL, Python, Node.js at PHP, at may API assistant
- **Nababasa ng makina:** OpenAPI 3.1 sa www.agilis.dating/openapi.json, Markdown sa www.agilis.dating/api-doc.md, at ang buong teksto para sa mga AI tool sa www.agilis.dating/llms-full.txt
- **Mga offer:** ilista ang inyong mga kategorya at ang mga interes; alamin ang presyo ng Offer bago ito gawin; gumawa, maglista, mag-pause, magpatuloy at magbura ng mga Offer; basahin ang mga resulta ng bawat Offer
- **Mga kaganapan:** i-preview, i-publish, ilista, i-edit, baguhin ang iskedyul, kanselahin at burahin ang mga kaganapan; basahin ang mga resulta ng bawat kaganapan

### Kumuha ng API key

1. Mag-sign in sa Ad Portal bilang Admin ng Organisasyon o Developer.
2. Piliin ang **Test mode** o Live gamit ang switch sa itaas ng pahina.
3. Pumunta sa **Mga API key** → **Gumawa ng Bagong Key**, bigyan ito ng pangalan at, kung gusto ninyo, ng petsa ng pag-expire.
4. **Kopyahin agad ang key.** Hindi na ninyo ito makikita muli.

Nagsisimula ang mga test key sa `pk_test_`, at ang mga live key sa `pk_live_`. Hanggang 10 key ang maaaring magkaroon ang bawat tao sa bawat mode. Agad na pinapalitan ng **Palitan** ang isang key, kaya i-update muna ang inyong mga system. Ipadala ang key sa `x-api-key` request header: `x-api-key: pk_test_…`.

### Bumuo nang ligtas

- Bumuo at mag-test gamit ang `pk_test_` key: libre ang mga test na Offer at kaganapan at hindi kailanman ipinapakita sa mga miyembro.
- Alamin ang presyo ng Offer gamit ang price-estimate endpoint bago ito gawin.
- Huwag ilagay ang mga key sa mga code repository at browser; tawagan ang API mula sa inyong server.

## Mga tanong

### Maaari bang pamahalaan ng isang ahensya ang ilang kliyente mula sa iisang account?

Oo. Iparehistro nang isang beses ang ahensya, at ilagay ang pangalan ng kliyente sa bawat Offer o kaganapan.

### Maaari bang magkaroon ng sariling invoice ang bawat kliyente?

Ibinibigay ang mga invoice sa inyong ahensya, isa bawat bayad. Batay sa mga ito, singilin muli ang inyong mga kliyente.

### May sandbox ba?

Oo. Ang Test mode, gamit ang mga `pk_test_` key, ay isang buong sandbox. Walang sinisingil at walang ipinapakita sa mga miyembro.

### Maaari ba akong magkonekta ng mga AI coding tool?

Oo. Ituro ang inyong tool sa www.agilis.dating/api-doc.md o sa www.agilis.dating/openapi.json.

Source: https://www.agilis.dating/tl/business/guide/agencies-and-api