Etkinliğini doğrudan kaynağından bildir

Neden bu API var

Etkinlik bilgisinin en doğru kaynağı, etkinliği düzenleyendir. Aracıdan aracıya taşınan bilgi eskiyor: saat değişiyor, mekân değişiyor, etkinlik iptal oluyor — ama internette hâlâ eski hâli duruyor. Bu API o zinciri kısaltır. Verini sen gönderirsin, sen güncellersin.

Anahtarını nasıl alırsın

İki yol var. Hangisi olduğuna göre anahtarın kapsamı değişir.

1 · Kendi sayfanı yönetiyorsan — anahtarı kendin üret

Bir mekân, sanatçı veya organizatörsen: siteye üye ol, Sayfam bölümünden sayfanı sahiplen. Sahipliğin onaylandığı anda aynı ekranda API anahtarı düğmesi çıkar. Tek tıkla üretirsin — kimseden izin beklemene gerek yok.

2 · Başkaları adına bildirim yapan bir sistemsen

Bir etkinlik yönetim ürünüysen (birden çok mekân/sanatçı müşterisi olan), sana platform anahtarı veririz. Bu anahtar başlangıçta boş kapsamla gelir; her müşteri için bir kez POST /baglanti ile bağlantı kurarsın (aşağıda). Yazman yeterli: [email protected]

Kimlik doğrulama

Her istekte API anahtarını Authorization başlığında gönder:

Authorization: Bearer ae_live_xxxxxxxxxxxxxxxxxxxx

Yayın kapısı — nasıl çalışır

Her anahtar bir kapsama sahiptir: adına bildirim yapabileceği mekân, sanatçı ve organizatörlerin listesi. Kapsamındaki bir varlık için gönderdiğin etkinlik doğrudan yayına çıkar; kapsam dışına gönderirsen bildirim onay kuyruğuna düşer — kaybolmaz, incelenir.

Uçlar

Etkinlik bildirme

POST /api/v1/etkinlik
Authorization: Bearer ae_live_...
Content-Type: application/json

{
  "kaynakId":   "PL-1001",                          // senin sistemindeki id
  "baslik":     "Yaz Gecesi Konseri",
  "aciklama":   "Açık havada bir yaz akşamı.",
  "baslangic":  "2026-08-14T21:00:00+03:00",        // ISO 8601
  "sehir":      "antalya",
  "kategori":   "konser",
  "mekanId":    "ven-panda-sahne",                 // /mekan-ara ile bul
  "sanatcilar": ["Sanatçı Adı"],
  "biletUrl":   "https://pandasahne.com/bilet/1001",
  "fiyat":      450
}

Alanlar

Yanıt

{
  "ok": true,
  "durum": "yayinda",          // kapsamındaysa
  "kaynakId": "PL-1001",
  "etkinlikId": "evt-yaz-gecesi-konseri-2026-08-14",
  "url": "https://antalyaetkinlikleri.com.tr/etkinlik/evt-yaz-gecesi-konseri-2026-08-14/"
}

Kapsamın dışındaki bir mekâna gönderdiysen "durum": "kuyrukta" döner ve bir talepId alırsın — bildirim kaybolmaz, incelenmeye alınır.

İptal ve erteleme

POST /api/v1/etkinlik/PL-1001/iptal

{ "durum": "EventCancelled", "not": "Sanatçı rahatsızlığı" }

Erteleyip yeni tarih vermek için:

{
  "durum": "EventRescheduled",
  "yeniBaslangic": "2026-10-05T21:00:00+03:00"
}

Bilet linki

biletUrl gönderirsen, sitedeki Bilet Al butonu kendi yönlendirme ucumuzdan (/bilet/<id>) geçerek senin sayfana çıkar. Kullanıcı için fark yoktur: tek tıkla senin bilet sayfandadır.

Bu yönlendirme bize tıklama sayısını verir — hangi etkinliğe ne kadar ilgi geldiğini ölçebiliriz. Kişisel veri toplanmaz; yalnız etkinlik, kaynak ve zaman kaydedilir.

Hatalar

Her hata aynı biçimde döner: makine için hata kodu, insan için mesaj, ve çoğu zaman ne yapman gerektiğini söyleyen bir ipucu.

{
  "ok": false,
  "hata": "dogrulama",
  "mesaj": "Etkinlik kabul edilmedi.",
  "eksikler": [
    "kategori geçersiz: \"rock\" · geçerli: konser, tiyatro, stand-up, ..."
  ]
}

Hızlı başlangıç

# 1 · anahtarını test et
curl -H "Authorization: Bearer $ANAHTAR" \
  https://antalyaetkinlikleri.com.tr/api/v1/ben

# 2 · mekânını bul
curl -H "Authorization: Bearer $ANAHTAR" \
  "https://antalyaetkinlikleri.com.tr/api/v1/mekan-ara?q=panda sahne"

# 3 · bağlantı kur (bir kez)
curl -X POST -H "Authorization: Bearer $ANAHTAR" -H "Content-Type: application/json" \
  https://antalyaetkinlikleri.com.tr/api/v1/baglanti \
  -d '{"tip":"mekan","entityId":"ven-panda-sahne","eposta":"[email protected]"}'

# 4 · etkinliğini bildir
curl -X POST -H "Authorization: Bearer $ANAHTAR" -H "Content-Type: application/json" \
  https://antalyaetkinlikleri.com.tr/api/v1/etkinlik \
  -d '{"kaynakId":"PL-1001","baslik":"Yaz Gecesi","baslangic":"2026-08-14T21:00:00+03:00",
       "sehir":"antalya","kategori":"konser","mekanId":"ven-panda-sahne"}'

Sınırlar

• Dakikada 60 istek, günde 1000 bildirim (artırılabilir — yaz yeter).
• Şu an yalnız Antalya etkinlikleri yayınlanır. Türkiye geneli için ölçek büyüdükçe aynı veri modeliyle açılacak.
• Yayına alınan etkinlik siteye birkaç dakika içinde yansır.

Anahtar almak için

Mekân, sanatçı, organizatör ya da bir etkinlik yönetim sistemiysen yaz: [email protected]. Kim olduğunu ve hangi mekân/sanatçı adına bildirim yapacağını belirt.