# Ajanslar, ekipler ve API

Ajanslar müşterilerinin reklamını Agilis'te her müşterinin adıyla nasıl verir; ekip rolleri, bakiyeler ve faturalar nasıl işler; Agilis REST API nasıl kullanılır.

**Kısaca:** Bir ajans kendi yasal adıyla bir kez kaydolur ve her müşterinin adını **Üyelere görünen ad** alanına girerek müşterileri adına reklam verir. Ödemeyi ajans yapar, bakiyeleri ajans tutar ve faturaları ajans alır. Geliştiriciler, Reklam Portalı'ndan alınan API anahtarlarıyla **Agilis REST API** (https://ads.agilis.dating) üzerinden fırsat ve etkinlik oluşturup yönetebilir; test anahtarları ücretsizdir ve üyelere hiçbir zaman gösterilmez.

## Ajanslar için

1. **Ajansı kaydedin** ve bunu ajansın kendi yasal adıyla yapın. → [Nasıl kaydolunur?](https://www.agilis.dating/tr/business/guide/register)
2. Bir fırsat veya etkinlik oluştururken **müşterinizin adını** **Üyelere görünen ad** alanına girin. Üyeler sizin adınızı değil, müşterinin adını görür.
3. Bir müşteri adına reklam verebilmek için o müşteriden yetki almış olmanız gerekir. Reklam Şartları ve Koşulları bu konudaki sorumluluğu ajansa yükler.

**Ödemeyi kim yapar, faturayı kim alır?**

- Ödeme, ajansınızın hesabından ve ajansınızın fatura para biriminde yapılır.
- Ajansınızdaki her kişinin kendi bakiyesi vardır ve ödemelerini bu bakiyeden yapar. Kuruluş bakiyesi bunların toplamıdır. → [Bakiyeler nasıl işler?](https://www.agilis.dating/tr/business/guide/pricing)
- Faturalar ve sonuçlar ajansınızın adına düzenlenir ve her ödeme için bir fatura kesilir; böylece her müşterinize ayrıca fatura kesebilirsiniz.
- Her müşterinin harcamalarını ayrı tutmak için her müşteriye ayrı bir fırsat veya etkinlik kullanın ve müşteriye o fırsatın ya da etkinliğin faturasına göre fatura kesin.

## Ekip rolleri

Kuruluş Yöneticileri ve Reklamverenler Reklam Portalı'nda, Geliştiriciler ise API üzerinden çalışır. Geliştiriciler Reklam Portalı'nda fırsat veya etkinlik oluşturamaz; ancak API anahtarlarıyla bunları API üzerinden oluşturabilir, yayınlayabilir ve ödemelerini yapabilir. Anahtarlarının nasıl kullanıldığından işletmeniz sorumludur. Tablonun tamamı [Ekip rolleri ve izinler](https://www.agilis.dating/tr/business/guide/getting-started) sayfasındadır.

## Agilis REST API

- **Temel URL:** https://ads.agilis.dating
- **Başvuru belgeleri:** www.agilis.dating/api-doc (cURL, Python, Node.js ve PHP örnekleri ve bir API asistanıyla)
- **Makine tarafından okunabilir:** OpenAPI 3.1 www.agilis.dating/openapi.json adresinde, Markdown www.agilis.dating/api-doc.md adresinde, yapay zekâ araçları için tam metin ise www.agilis.dating/llms-full.txt adresinde
- **Fırsatlar:** kategorilerinizi ve ilgi alanlarını listeleyin; bir fırsatı oluşturmadan önce fiyatını hesaplayın; fırsat oluşturun, listeleyin, duraklatın, sürdürün ve silin; her fırsatın sonuçlarını görüntüleyin
- **Etkinlikler:** etkinlikleri önizleyin, yayınlayın, listeleyin, düzenleyin, yeniden planlayın, iptal edin ve silin; her etkinliğin sonuçlarını görüntüleyin

### API anahtarı alın

1. Reklam Portalı'na Kuruluş Yöneticisi veya Geliştirici olarak giriş yapın.
2. Sayfanın üstündeki geçiş düğmesiyle **Test modu** ya da Canlı mod arasında seçim yapın.
3. **API anahtarları** → **Yeni anahtar oluştur** bölümüne gidin; anahtara bir ad ve isterseniz bir son kullanma tarihi verin.
4. **Anahtarı hemen kopyalayın.** Anahtarı bir daha göremezsiniz.

Test anahtarları `pk_test_` ile, canlı anahtarlar `pk_live_` ile başlar. Her kişi her modda en fazla 10 anahtara sahip olabilir. **Yenile** anahtarı anında değiştirir; bu nedenle önce sistemlerinizi güncelleyin. Anahtarı `x-api-key` istek başlığında gönderin: `x-api-key: pk_test_…`.

### Güvenle geliştirin

- `pk_test_` anahtarıyla geliştirip test edin: test fırsatları ve etkinlikleri ücretsizdir ve üyelere hiçbir zaman gösterilmez.
- Bir fırsatı oluşturmadan önce fiyat tahmini uç noktasıyla fiyatını hesaplayın.
- Anahtarları kod depolarından ve tarayıcılardan uzak tutun; API'yi sunucunuzdan çağırın.

## Sorular

### Bir ajans tek bir hesaptan birden fazla müşteriyi yönetebilir mi?

Evet. Ajansı bir kez kaydedin ve her fırsatta veya etkinlikte müşterinin adını belirtin.

### Her müşteri için ayrı fatura alınabilir mi?

Faturalar ajansınız adına, her ödeme için bir tane olacak şekilde düzenlenir. Müşterilerinize bu faturalara göre fatura kesin.

### Deneme ortamı (sandbox) var mı?

Evet. `pk_test_` anahtarlarıyla kullanılan Test modu eksiksiz bir deneme ortamıdır. Hiçbir ücret alınmaz ve üyelere hiçbir şey gösterilmez.

### Yapay zekâ kodlama araçlarını bağlayabilir miyim?

Evet. Aracınızı www.agilis.dating/api-doc.md veya www.agilis.dating/openapi.json adresine yönlendirin.

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