# Agensi, tim lan API

Cara agensi ngiklanaken klien ing Agilis nganggé nami saben klien, cara makarya peran tim, saldo lan tagihan, saha cara ngginakaken Agilis REST API.

**Ringkesipun:** agensi cekap ndaftar sapisan, nganggé nami resminipun piyambak, lajeng masang iklan kangge klienipun kanthi nglebetaken nami saben klien ing **Nama tampilan**. Agensi ingkang mbayar, nyekel saldo lan nampi tagihan. Pangembang saged damel lan ngatur promo lan acara lumantar **Agilis REST API** (https://ads.agilis.dating) ngginakaken kunci API saking Portal Iklan; kunci uji gratis lan mboten nate dipunpitontonaken dhateng anggota.

## Kangge agensi

1. **Daftaraken agensi** nganggé nami resminipun piyambak. → [Cara ndaftar](https://www.agilis.dating/jv/business/guide/register)
2. Nalika damel promo utawi acara, lebetaken **nami klien** panjenengan ing **Nama tampilan**. Anggota ningali nami klien, sanes nami panjenengan.
3. Panjenengan kedah pikantuk wewenang saking saben klien kangge masang iklan atas nami piyambakipun. Katemtuan Iklan ndadosaken agensi tanggel jawab bab menika.

**Sinten ingkang mbayar, lan sinten ingkang nampi tagihan**

- Akun agensi panjenengan ingkang mbayar, ngginakaken mata uang tagihan agensi panjenengan.
- Saben tiyang ing agensi panjenengan gadhah saldo piyambak lan mbayar saking saldo menika. Saldo organisasi inggih menika gunggungipun. → [Cara makarya saldo](https://www.agilis.dating/jv/business/guide/pricing)
- Tagihan lan asil nganggé nami agensi panjenengan, satunggal tagihan kangge saben pambayaran, supados panjenengan saged nagih malih dhateng saben klien.
- Supados pengeluaran saben klien kapisah, ginakaken satunggal promo utawi acara kangge saben klien lan tagih malih klien adhedhasar tagihanipun.

## Peran tim

Admin Organisasi lan Pamasang Iklan makarya ing Portal Iklan; Pangembang makarya lumantar API. Pangembang mboten saged damel promo utawi acara ing Portal Iklan, nanging kanthi kunci API-nipun saged damel, nayangaken lan mbayar promo lan acara lumantar API, lan usaha panjenengan tanggel jawab tumrap cara ngginakaken kunci-kuncinipun. Tabel lengkap wonten ing [Peran tim lan idin](https://www.agilis.dating/jv/business/guide/getting-started).

## Agilis REST API

- **URL dhasar:** https://ads.agilis.dating
- **Referensi:** www.agilis.dating/api-doc, kanthi conto ing cURL, Python, Node.js lan PHP, saha asisten API
- **Saged dipunwaos mesin:** OpenAPI 3.1 ing www.agilis.dating/openapi.json, Markdown ing www.agilis.dating/api-doc.md, lan teks lengkap kangge piranti AI ing www.agilis.dating/llms-full.txt
- **Promo:** tampilaken daftar kategori lan minat; etang regi promo saderengipun damel; damel, tampilaken daftar, ngendheg, nglajengaken lan mbusak promo; maos asil saben promo
- **Acara:** pratinjau, nayangaken, nampilaken daftar, ngowahi, nggantos jadwal, mbatalaken lan mbusak acara; maos asil saben acara

### Pikantuk kunci API

1. Mlebet dhateng Portal Iklan minangka Admin Organisasi utawi Pangembang.
2. Pilih **Mode Uji** utawi Mode Langsung nganggé saklar ing sisih inggil kaca.
3. Tindak dhateng **Kunci API** → **Damel Kunci Enggal**, paringi nama lan, menawi kersa, tanggal kadaluwarsa.
4. **Enggal salin kunci menika.** Panjenengan mboten saged ningali malih.

Kunci uji dipunwiwiti kanthi `pk_test_`; kunci langsung dipunwiwiti kanthi `pk_live_`. Saben tiyang saged gadhah ngantos 10 kunci ing saben mode. **Gantos kunci** nggantos kunci langsung, mila enggalaken sistem panjenengan rumiyin. Kirim kunci ing header panyuwunan `x-api-key`: `x-api-key: pk_test_…`.

### Damel kanthi aman

- Damel lan uji nganggé kunci `pk_test_`: promo lan acara uji gratis lan mboten nate dipunpitontonaken dhateng anggota.
- Etang regi promo nganggé endpoint price-estimate saderengipun panjenengan damel.
- Sampun ngantos nyimpen kunci ing repositori kode utawi browser; aksesa API saking server panjenengan.

## Pitakenan

### Menapa agensi saged ngatur pinten-pinten klien saking satunggal akun?

Saged. Daftaraken agensi sapisan lan serat nami klien ing saben promo utawi acara.

### Menapa saben klien saged gadhah tagihan piyambak?

Tagihan dipunterbitaken dhateng agensi panjenengan, satunggal kangge saben pambayaran. Tagih malih klien panjenengan adhedhasar tagihan menika.

### Menapa wonten sandbox?

Wonten. Mode Uji, kanthi kunci `pk_test_`, inggih menika sandbox lengkap. Mboten wonten ingkang dipuntagih lan mboten wonten ingkang dipunpitontonaken dhateng anggota.

### Menapa kula saged nyambungaken piranti AI kangge nyerat kode?

Saged. Arahaken piranti panjenengan dhateng www.agilis.dating/api-doc.md utawi www.agilis.dating/openapi.json.

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