Organizasyonunuzun kendi web sitesi, etkinliklerini, programını, konuşmacılarını, sponsorlarını ve ekibini EventStage'den çeker; tasarım sizin, veri buradan.
API adresi:
https://eventstage.com.tr/api/integration/v1
https://eventstage.com.tr/api/integration/v1 altına, anahtarla gönderin. Tüm uçlar
GET'tir; 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.
Anahtar esk_ ile başlar. İki başlıktan birini kullanın; 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.
fetch: anahtar sayfa kaynağında görünür, yani
herkese açıktır. Portalda anahtarın izinli site adreslerine sitenizi yazın;
başka bir sitenin sayfasından gelen istek 403 API_KEY_ORIGIN_NOT_ALLOWED
alır. CORS bu uçlar için açıktır; tarayıcı isteğinde çerez kullanılmaz.
Cache-Control: private, max-age=60: aynı yanıtı bu süre
boyunca yeniden istemeniz gerekmez.
ETag taşır. İkinci istekte If-None-Match
gönderin; içerik değişmediyse gövdesiz döner.
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, yani süresiz önbelleğe alabilirsiniz.
/api/integration/v1
Tüm yollar https://eventstage.com.tr/api/integration/v1 ile başlar.
| Yöntem | Yol | Ne döner |
|---|---|---|
| GET | /organization | Anahtarın ait olduğu organizasyonun herkese açık profili. Nesne: Organizasyon |
| GET | /team | Ekip: portalda "web sitesinde göster" işaretli üyeler, sıra numarasına göre. Liste: EkipÜyesi[] |
| GET | /speakers | Organizasyonda konuşmacılığı onaylanmış herkes, birer kez, ada göre: yayınlanmış bir etkinliğin bir oturumunda ya da etkinliğin kendisinde konuşmacı olmayı kabul etmiş olanlar. İptal edilmiş oturumlar ve yayınlanmamış etkinlikler sayılmaz; yalnızca davet edilmiş olanlar listelenmez. Liste: Konuşmacı[] |
| GET | /sponsors | Organizasyonun tüm sponsorları, ada göre. Tür etkinliğe ait olduğu için burada boştur. Liste: Sponsor[] |
| GET | /events |
Yayınlanmış etkinlikler, sayfa sayfa. Taslaklar, iptal edilenler ve askıya alınanlar hiç dönmez.
Sayfalı liste: items (EtkinlikÖzeti), page, pageSize, totalCount, hasMore.
|
| GET | /events/{idVeyaSlug} |
Bir etkinliğin tamamı: bilgileri, programı konuşmacılarıyla, tüm konuşmacıları ve sponsorları. Bir etkinlik sayfası için gereken her şey tek istekte.
Nesne: EtkinlikDetayı
|
| GET | /events/{idVeyaSlug}/sessions |
Etkinliğin programı: planlanmış oturumlar, sırayla, her biri konuşmacılarıyla.
Liste: Oturum[]
|
| GET | /events/{idVeyaSlug}/speakers |
Etkinlikte konuşan herkes, birer kez, program sırasıyla. Konuşmacılar oturumlara bağlandığı için programı olmayan bir etkinliğin konuşmacı listesi boştur.
Liste: Konuşmacı[]
|
| GET | /events/{idVeyaSlug}/sponsors |
Etkinliğin sponsorları, türleri ve rozetleriyle, organizatörün belirlediği sırada.
Liste: Sponsor[]
|
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.
Bir an, iki biçimde: hesaplamak için UTC, yazdırmak için mekânın duvar saati.
Sitenize doğrudan gömebileceğiniz bir görsel.
Etkinliğin platformdaki kategorisi. Liste EventStage'e aittir; organizatör bunlardan birini seçer.
Organizasyonun herkese açık profili.
Ekip sayfasındaki bir üyenin web sitesi profili. E-posta ya da hesap bilgisi içermez; ekipten çıkarılan kişi listeden hemen düşer.
Bir konuşmacı profili.
Bir sponsor; havuzdan ya da bir etkinliğin listesinden. Etkinlik listesinde sponsorun o etkinlikteki türü de gelir.
Programdaki bir oturum.
Listelerdeki etkinlik.
Bir etkinliğin tamamı.
Her hata RFC 7807 biçiminde bir JSON gövdeyle gelir: status, title,
detail ve programınızın dallanacağı errorCode.
| HTTP | errorCode | Anlamı |
|---|---|---|
| 401 | API_KEY_INVALID | Anahtar gönderilmemiş, tanınmıyor ya da iptal edilmiş. Portaldan yeni bir anahtar üretin. |
| 403 | ORGANIZATION_SUSPENDED | Organizasyon askıya alınmış ya da kapatılmış. Verileri herkese açık sitede olduğu gibi burada da görünmez. |
| 403 | API_KEY_ORIGIN_NOT_ALLOWED | İstek tarayıcıdan, anahtarın izin listesinde olmayan bir siteden geldi. Portalda adresi ekleyin ya da sunucudan çağırın. |
| 404 | EVENT_NOT_FOUND | Böyle bir etkinlik yok ya da yayında değil. |
| 400 | BAD_REQUEST | Bir parametre geçersiz; ayrıntı yanıttaki detail alanında. |
| 429 | RATE_LIMITED | Bu anahtar dakikalık sınırını aştı. Retry-After başlığındaki saniye kadar bekleyin ve yanıtları önbelleğe alın. |
Kayıt formunu kendi sitenizde barındırmanıza gerek yok — barındırmamanız da gerekir. Etkinliğin başvuru sayfası EventStage'de durur; sitenize eklediğiniz şey ona giden bir bağlantıdır. Adres her etkinlik için şu biçimdedir:
https://eventstage.com.tr/o/{organizasyonSlug}/e/{etkinlikSlug}/kaydol
Adres, etkinlik yanıtlarındaki applicationUrl alanında hazır gelir; slug'ları
da slug alanından alabilirsiniz. Portalda etkinlik sayfasındaki
Siteme ekle panelinde de adres hazır olarak durur.
<a href="https://eventstage.com.tr/o/toplulugunuz/e/ornek-konferans-2026/kaydol">Kaydol</a>Katılımcı adını ve e-postasını yazar, adresine gelen 6 haneli kodu girer ve kaydı tamamlanır. Hesabı yoksa açılır, şifre sorulmaz. Bu adrese bağlantı vermek için API anahtarına ihtiyacınız yoktur ve herhangi bir izin listesi tutulmaz: sayfa, etkinliğin herkese açık sayfası kadar açıktır.
curl -H "Authorization: Bearer esk_…" \
"https://eventstage.com.tr/api/integration/v1/events?timing=upcoming&pageSize=5"const response = await fetch("https://eventstage.com.tr/api/integration/v1/events/ornek-konferans-2026", {
headers: { "X-Api-Key": process.env.EVENTSTAGE_API_KEY }
});
const event = await response.json();
for (const session of event.sessions) {
console.log(session.start.local, session.name, session.speakers.map(s => s.name));
}GET /events/{slug} (kısaltılmış){
"id": "0199…",
"name": "Örnek Konferans 2026",
"slug": "ornek-konferans-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://eventstage.com.tr/media/0199…" },
"isRegistrationOpen": true,
"publicUrl": "https://eventstage.com.tr/o/toplulugunuz/e/ornek-konferans-2026",
"applicationUrl": "https://eventstage.com.tr/o/toplulugunuz/e/ornek-konferans-2026/kaydol",
"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": "…", "jobTitle": "…", "photo": { "url": "…" } } ],
"speakerNames": null
}
],
"speakers": [ { "name": "…", "jobTitle": "…" } ],
"sponsors": [ { "name": "…", "tier": "…", "logo": { "url": "…" } } ]
}