REST API v1

Marketplace API

Kampanyalarını doğrudan Yougee Marketplace'e entegre et. İçerik üreticilerine ulaş ve slot yönetimini otomatikleştir.

Temel URL

Tüm istekler bu adrese gönderilir.

https://wxahqscmzrxsrkanzona.supabase.co/functions/v1/marketplace-api

Kimlik doğrulama

Her istekte Authorization başlığı zorunludur. API anahtarın bir kez oluşturulur ve entegrasyonuna bağlıdır.

Başlık

Authorization: Bearer yg_<your_api_key>

Örnek

curl "https://wxahqscmzrxsrkanzona.supabase.co/functions/v1/marketplace-api/campaigns" \
  -H "Authorization: Bearer yg_a1b2c3d4e5f6..."

API anahtarını yalnızca sunucu tarafında kullan. İstemci tarafı kodunda asla paylaşma.

Uç noktalar

POST/campaigns
GET/campaigns
GET/campaigns/:id
PATCH/campaigns/:id
DELETE/campaigns/:id

POST /campaigns

Yeni bir kampanya oluşturur. Marketplace'te hemen yayına alınır.

cURL

curl -X POST "https://wxahqscmzrxsrkanzona.supabase.co/functions/v1/marketplace-api/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Summer Beauty Campaign",
    "brand_name": "GlowCo",
    "external_url": "https://brand.com/apply",
    "compensation": "$120 + free product",
    "compensation_type": "paid",
    "content_types": ["ugc", "reel"],
    "niche_tags": ["beauty", "skincare"],
    "slots_total": 10,
    "slots_remaining": 10
  }'

GET/campaigns

Entegrasyonuna ait kampanyaları listeler. Sayfalama: limit (en fazla 100) ve offset.

GET/campaigns/:id

Kimliğe göre tek bir kampanyayı getirir.

PATCH/campaigns/:id

Kampanyayı kısmen günceller. Yalnızca gönderilen alanlar değişir.

DELETE/campaigns/:id

Bir kampanyayı Marketplace'ten kaldırır (yumuşak silme).

Kampanya alanları

Alan	Tip	Açıklama
title	string	Kampanya başlığı	Zorunlu
brand_name	string	Marka adı	Zorunlu
external_url	string	Başvuru URL'si (kampanya sayfan)	Zorunlu
description	string	Kampanya açıklaması	İsteğe bağlı
compensation	string	Ödül metni (ör. '$120 + ücretsiz ürün')	İsteğe bağlı
compensation_type	enum	paid \| gifted \| gifted_plus \| commission	İsteğe bağlı
content_types	string[]	video \| image \| reel \| story \| ugc	İsteğe bağlı
requirements	string	Katılım gereksinimleri	İsteğe bağlı
deadline	ISO 8601	Başvuru son tarihi (ör. '2025-08-31')	İsteğe bağlı
slots_total	number	Toplam slot sayısı	İsteğe bağlı
slots_remaining	number	Kalan uygun slotlar	İsteğe bağlı
is_featured	boolean	Öne çıkan kampanya olarak göster	İsteğe bağlı
niche_tags	string[]	Niş etiketleri (ör. ['beauty','lifestyle'])	İsteğe bağlı
min_score	number	Minimum creator doğrulama skoru (0–100)	İsteğe bağlı

HTTP durum kodları

201Kampanya oluşturuldu
200Başarılı
204Silindi (gövde yok)
401Geçersiz veya pasif API anahtarı
403Başka bir entegrasyonun kaynağına erişim
404Kampanya bulunamadı
422Eksik veya geçersiz alan
500Sunucu hatası

Webhook desteği

Entegrasyon oluştururken bir webhook URL'i belirtirsen, kampanya olayları (oluşturma, güncelleme, silme) bu adrese POST edilir.

Gövde formatı

{
  "event":     "campaign.created",   // campaign.created | campaign.updated | campaign.deleted
  "data":      { /* full campaign object */ },
  "timestamp": "2025-04-10T12:34:56.789Z"
}

Entegrasyon başvurusu

API anahtarı almak için bize ulaş. Kurulum yaklaşık 5 dakika sürer.

hello@yougee.co