Entegrasyon API'si

Başlarken

1. Organizasyon sahibi portalda API erişimi sayfasından bir anahtar üretir. Anahtar bir kez gösterilir; güvenli bir yere kaydedin.
2. Her isteği https://event.solstage.com/api/integration/v1 altına, anahtarla gönderin.
3. Yanıtlar JSON'dur. Yalnızca okuma yapılır; API hiçbir şeyi değiştirmez.

Yalnızca yayınlanmış etkinlikler döner. Taslaklar, iptal edilenler, kayıtlı katılımcılar ve e-posta adresleri bu API'den hiçbir zaman çıkmaz. Konuşmacılarda yalnızca daveti kabul edenler, ekipte yalnızca "web sitesinde göster" işaretli üyeler görünür.

Kimlik doğrulama

Anahtarı iki başlıktan biriyle gönderin; ikisi de aynı işi görür:

Authorization: Bearer esk_xxxxxxxx…
X-Api-Key: esk_xxxxxxxx…

Anahtar tek bir organizasyona bağlıdır; hangi organizasyon olduğunu URL'de söylemezsiniz. Portalda iptal edilen anahtar bir sonraki istekte reddedilir. Askıya alınmış bir organizasyonun anahtarları, herkese açık sayfaları gibi, kapalıdır.

Tarayıcıdan mı, sunucudan mı?

Sunucudan (PHP, Node, .NET, bir statik site üreticisinin derleme adımı…): anahtar ziyaretçiye hiç görünmez. Portalda "izinli site adresleri" boş bırakılır. Tavsiye edilen yol budur.

Tarayıcıdan (sayfanızdaki JavaScript ile fetch): anahtar sayfa kaynağında görünür, yani herkese açıktır. Bu durumda portalda anahtarın izinli site adreslerine sitenizi yazın; API, başka bir sitenin sayfasından gelen istekleri o anahtarla reddeder. CORS bu uçlar için açıktır; tarayıcı isteğinde çerez kullanılmaz.

Önbellek ve sınırlar

• Her yanıt bir ETag taşır. İkinci istekte If-None-Match gönderin; içerik değişmediyse gövdesiz 304 alırsınız.
• Cache-Control: private, max-age=60: aynı yanıtı bir dakika boyunca yeniden istemeniz gerekmez.
• Anahtar başına dakikada 600 istek kabul edilir. Aşınca 429 ve Retry-After döner. Sitenizde yanıtları sunucu tarafında birkaç dakika önbelleğe almanız yeterlidir; sayfa görüntülemesi başına istek atmayın.
• Görsel adresleri kalıcıdır; görsel değişince adres de değişir. Süresiz önbelleğe alabilirsiniz.

Uçlar

Tüm yollar https://event.solstage.com/api/integration/v1 ile başlar.

Veri şekilleri

Alan adları JSON'da küçük harfle başlar (fullName). "Boş olabilir" işaretli alanlar null gelebilir; diğerleri her zaman doludur. Tarihler ISO 8601'dir.

Hatalar

Her hata RFC 7807 biçiminde bir JSON gövdeyle gelir: status, title, detail ve programınızın dallanacağı errorCode.

Örnekler

curl

curl -H "Authorization: Bearer esk_…" \
  "https://event.solstage.com/api/integration/v1/events?timing=upcoming&pageSize=5"

Sunucu tarafı JavaScript (Node)

const response = await fetch("https://event.solstage.com/api/integration/v1/events/2026-devfest", {
  headers: { "X-Api-Key": process.env.EVENTSTAGE_API_KEY }
});
const event = await response.json();

for (const session of event.sessions) {
  const start = new Date(session.start.local);
  console.log(session.name, start.toLocaleTimeString("tr-TR"), session.speakers.map(s => s.name));
}

Örnek yanıt: GET /events/{slug} (kısaltılmış)

{
  "id": "0199…",
  "name": "DevFest Gaziantep 2026",
  "slug": "devfest-2026",
  "timing": "upcoming",
  "start": { "utc": "2026-11-14T06:00:00Z", "local": "2026-11-14T09:00:00+03:00", "timeZoneId": "Europe/Istanbul" },
  "end":   { "utc": "2026-11-14T15:00:00Z", "local": "2026-11-14T18:00:00+03:00", "timeZoneId": "Europe/Istanbul" },
  "cover": { "fileId": "0199…", "url": "https://event.solstage.com/media/0199…" },
  "isRegistrationOpen": true,
  "publicUrl": "https://event.solstage.com/o/gdg-gaziantep/e/devfest-2026",
  "sessions": [
    {
      "name": "Açılış",
      "room": "Ana salon",
      "start": { "utc": "2026-11-14T06:30:00Z", "local": "2026-11-14T09:30:00+03:00", "timeZoneId": "Europe/Istanbul" },
      "speakers": [ { "name": "Ada Lovelace", "jobTitle": "GDE", "photo": { "url": "…" } } ],
      "speakerNames": null
    }
  ],
  "speakers": [ { "name": "Ada Lovelace", "jobTitle": "GDE" } ],
  "sponsors": [ { "name": "Örnek A.Ş.", "tier": "Altın", "logo": { "url": "…" } } ]
}