Skip to content

Winglark

Buradan başlayın

API ve webhook’lar

Kullanımda

Etkinlik yönetimi için bir API, imzalı webhook’larla.

Etkinlikleri, misafirleri, yanıtları ve girişleri okuyun; kendi sistemlerinizden misafir ekleyip güncelleyin ve etkinlikte bir şey olduğu anda imzalı bir mesaj alın.

Erişim isteGeliştirici başvurusunu açın
  • REST API v1
  • On üç webhook olayı
  • Professional ve Agency
Uç noktanıza ulaştığı hâliyle bir rsvp.submitted webhook’u
POST /winglark HTTP/1.1
Winglark-Signature: t=1762338012,v1=5f2b…c9e1
Winglark-Event: rsvp.submitted
Winglark-Delivery: 7c1e9a42-…

{
  "type": "rsvp.submitted",
  "created_at": "2026-11-05T18:40:12.481Z",
  "event_id": "6f1c2a7e-…",
  "data": {
    "response": "yes",
    "party_size": 2,
    "guest": { "first_name": "Ada", "email": "a•••@example.com" }
  }
}

Uç noktanın görmesine izin verilmedikçe iletişim bilgileri maskeli kalır.

Ne yapar

Sistemleriniz, etkinliğin kendisi tarafından güncel tutulur.

Buradaki her şey bugün Professional ve Agency planlarında çalışıyor.

Etkinliği okuyun
Etkinlikler, misafirler, yanıtlar ve girişler; büyük bir liste imleçle parça parça gelir.
Listeyi yazın
Bir bilet sitesinden, CRM’den ya da formdan misafir ekleyin veya güncelleyin. Tekrar anahtarı yeniden denemeyi zararsız kılar.
Olduğu anda duyun
Yanıtlar, davetiyeler, kapı, biletler, oturma planı ve yaka kartları için zaman damgasıyla imzalı webhook’lar.
Her gönderimi görün
Her durum ve denemenin yazıldığı bir kayıt, yeniden gönderim, deneme olayı ve hata veren uç noktaların duraklatılması.

Nasıl çalışır

Üç adım.

  1. Bir anahtar oluşturunEntegrasyonlar’da yetkilerini ve dilerseniz bir son kullanma tarihi seçin. Kopyalayın: bir kez gösterilir.
  2. Bir uç nokta ekleyinHTTPS adresini ve duyması gereken olayları verin. İmzayı kontrol etmek için bir deneme olayı gönderin.
  3. Üzerine kurunAnahtarla API’yi çağırın ve her webhook’a göre hareket edin. Geliştirici başvurusunda her yol ve alan var.

Ürünün içinde

Anahtarlar, webhook’lar ve her gönderim tek ekranda.

Entegrasyonlar çalışma alanı ayarlarındadır. Anahtar ihtiyaç duyduğu yetkilerle oluşturulur ve bir kez gösterilir; uç noktaya duyması gereken olaylar verilir; gönderim kaydı neyin gittiğini, ne cevap geldiğini ve neyin yeniden denendiğini gösterir.

Örnek bir çalışma alanı, anahtarlar ve gönderimler. Ekranlar ürün çalıştığı hâliyle çizildi.

API ve webhook’larKullanımda

Neye ihtiyacınız var

Professional ya da Agency planında bir çalışma alanı ve bir HTTPS isteğini karşılayabilecek biri. Free, Starter ve Tek Etkinlik API’yi içermez.

Geliştirici başvurusunu açın →Entegrasyonlar →Planları karşılaştırın →

Bir uç noktanın abone olabileceği olaylar

  • guest.created
  • guest.updated
  • guest.archived
  • rsvp.submitted
  • invitation.sent
  • invitation.delivered
  • invitation.bounced
  • checkin.admitted
  • ticket.issued
  • event.published
  • event.cancelled
  • seatmap.published
  • badge.printed

Sorular

Etkinlik davetli listeleri için bir REST API var mı?

Evet: her etkinlik için misafirleri listeleyin, okuyun, oluşturun ve güncelleyin; yanıtları ve girişleri okuyun. Yanıtlar JSON’dur, listeler imleçle sayfalanır ve oluşturma istekleri tekrar anahtarı kabul eder.

Webhook’lar nasıl imzalanır?

Zaman damgası ve ham gövde üzerinde bir HMAC ile; imza Winglark-Signature başlığında gelir. Gizli anahtarı yenilediğinizde eskisi bir süre daha geçerli kalır, geçiş sırasında hiçbir mesaj kaybolmaz.

İstek sınırı var mı?

Evet, anahtar başına. Sınırı aşan bir istek 429 durumuyla yanıtlanır ve yanıtın bildirdiği bekleme süresinden sonra yinelenebilir.

Bir anahtar yalnızca okumayla sınırlanabilir mi?

Evet. Anahtar yalnızca oluşturulurken verilen yetkileri taşır — örneğin etkinlikleri ve yanıtları okumak, hiçbir şey yazmamak.

Sistemlerinize bir anahtar verin.

Professional ve Agency planlarında, çalışma alanı ayarlarından.

Erişim isteGeliştirici başvurusunu açın