Gerçek zamanlı yolculuklarda olay API'sini kullanma

Etkinlik API’si, etkinlikler, oturumlar, oturum kategorileri, biletler, konuşmacılar ve sponsorluk verilerine erişmek için kullanılan programatik bir yöntemdir. Buna ek olarak, olay API'si olaylara ve oturumlara kaydolmanıza olanak tanır.

Erişilen API, HTTPS protokolü üzerinden erişilir ve web uygulaması belirteci oluşturduğunuzda aldığınız API uç noktasından erişilir. Tüm veriler JSON olarak gönderilir ve alınır.

Olay API'sine kaydolma

Olay yönetimi> altındaki Ayarlar bölümünde yeni bir web uygulaması oluşturun. Doğru kaynağı seçmek önemlidir. Örneğin, https://contoso.com seçildiğinde, farklı bir etki alanında barındırılan JavaScript, olay yönetimi API'sine erişemeyecektir.

Olay API ayarları ekran görüntüsü.

Bir web uygulaması oluşturduktan sonra , Uç Nokta belgelerinde (Önizleme) OpenAPI belirtiminin bağlantısını görürsünüz.

Olay API'si uç noktası ekran görüntüsü.

Bağlantıyı seçip API sözleşmesini kopyalayıp Swagger Düzenleyicisi gibi bir OpenAPI düzenleyicisine yapıştırabilirsiniz. Bu düzenleyici, API'nizi bulmak için kullanabileceğiniz bir sarmalayıcıyı otomatik olarak önceden oluşturur. API'nize erişmek için yetkilendirilmelisiniz ( Belirteç sütununu sağlayın).

Olay API'si Swagger Düzenleyicisi ekran görüntüsü.

Olay sayfası veya olay portalı oluşturma

Olay API'si, "Olay API'sini kullanarak özel çözüm" yayımlama seçeneğini kullanarak canlı ve yayımlanmış tüm kullanılabilir olayları listeleyen özelleştirilmiş bir olay sayfası ve olay portalı oluşturmanıza olanak tanır. Olay API'si şunları yapmanızı sağlar:

  • Adlarını, açıklamalarını, konumlarını ve saatlerini içeren canlı etkinliklerin listesini alın.
  • Olay sayfası için olayla ilgili aşağıdaki gibi önemli bilgileri almanıza olanak tanır:
    • Name
    • Time
    • Yer
    • Olay QR kodu
    • Capacity
    • Oturum listesi
    • Konuşmacı listesi
    • Sponsorların ve logolarının listesi

Özel olay kayıt deneyimi oluşturma

Olay API'si ayrıca gerçek zamanlı pazarlama formlarını kullanmaya gerek kalmadan bir kayıt gönderimi oluşturmanıza olanak tanırken eşleştirme stratejisi, onay, hedef kitle ayarları ve daha fazlası gibi önemli özelliklerden yararlanmaya devam eder.

İlk olarak, Ayarlar>Olay yönetimi>Olay kayıt ayarları'na giderek hedef kitlenizin temel ayarlarını tanımlayın ve şunları tanımlayın:

  1. Varsayılan hedef kitle
  2. Varsayılan eşleştirme kuralı
  3. Varsayılan uyumluluk profili

Varsayılan olay kayıt ayarları, API'den gelen gönderimler işlenirken kullanılır. Kayıt ayarlarını yaptıktan sonra olay API'sinin gönderim uç noktası şunları yapmanızı sağlar:

  1. Bir olay için kayıt gönderimi oluşturma:
{ 
    "attendees": [ 
        { 
            "lastName": "Sample Contact Last Name", 
            "firstName": "Sample Contact First Name", 
            "email": "email@contoso.com", 
            "responses": [ 
                { 
                    "id": "jobtitle", 
                    "value": "Sample Contact Job Title" 
                }, 
                { 
                    "id": "customUnmappedField1", 
                    "value": "Sample Custom Unmapped Field 1" 
                }, 
                { 
                    "id": "customUnmappedField2", 
                    "value": "Sample Custom Unmapped Field 2" 
                } 
            ] 
        } 
    ] 
}
  1. Oturum için kayıt gönderimi oluşturma:
{ 
    "attendees": [ 
        { 
            "lastName": "Sample Contact Last Name", 
            "firstName": "Sample Contact First Name", 
            "email": "email@contoso.com", 
            "responses": [ 
                { 
                    "id": "jobtitle", 
                    "value": "Sample Contact Job Title" 
                } 
            ], 
            "attendeeSessions": [ 
                { 
                    "sessionId": "d5f513c6-989f-f011-bbd3-000d3a5b6385" 
                }, 
                { 
                    "sessionId": "f5d4e4b9-989f-f011-bbd3-000d3a5b6385" 
                } 
            ] 
        } 
    ] 
}
  1. Bekleme listesi kaydı oluşturma:
{
    "attendees": [ 
        { 
            "lastName": "Sample Contact Last Name", 
            "firstName": "Sample Contact First Name", 
            "email": "email@contoso.com", 
            "waitlisted": true, 
            "responses": [ 
                { 
                    "id": "jobtitle", 
                    "value": "Sample Contact Job Title" 
                }, 
                { 
                    "id": "customUnmappedField1", 
                    "value": "Sample Custom Unmapped Field 1" 
                }, 
                { 
                    "id": "customUnmappedField2", 
                    "value": "Sample Custom Unmapped Field 2" 
                } 
            ] 
        } 
    ]
}

Performans ve sınırlar

Olay API'si zaman uyumsuz işleme, akıllı önbelleğe alma ve yerleşik yeniden deneme mantığı aracılığıyla yüksek hacimli kayıt senaryolarını destekler.

Olay API'si aracılığıyla bir kayıt isteği geldiğinde sistem:

  • Olayın etkin olduğunu ve tüm ilgili varlıkların geçerli durumda olduğunu doğrular
  • Çağırana anında bir başarı yanıtı döndürür.
  • Olay kaydını ve ilişkili varlıkları zaman uyumsuz olarak oluşturmak için bir arka plan iş öğesi işlemcisi başlatır.

Önbelleğe Alma Davranışı

Okuma önbelleği: Sistem, olay ve varlık doğrulaması için 10 dakikalık bir önbellek uygular. Bu, Dataverse'de gereksiz okumaları azaltır ve yük altında aktarım hızını artırır.

Note

Okuma önbelleği yalnızca doğrulamayı etkiler, kayıt kayıtlarının kendisini etkilemez.

Yeniden deneme mantığı ve hata işleme

Arka plan işlemcisi bir olay kaydı oluşturamazsa sistem otomatik olarak altı saate kadar yeniden denenir. Bu, el ile müdahale gerektirmeden veri güvenilirliğini güvence altına alan zaman uyumlu ve zaman uyumsuz hata senaryoları için geçerlidir.

Aktarım hızı ve Dataverse sınırları

Formsuz kayıt senaryoları için birincil sınırlayıcı faktör, Dataverse'de bilet kayıt varlıklarının oluşturulma oranıdır. Normal koşullarda Dataverse, kullanıcı ve web sunucusu başına beş dakikalık bir kayan pencere içinde 6.000 API isteği sınırı uygular. Bu sınırlar aşılırsa platform hata 429 Too Many Requests döndürebilir. Daha fazla bilgi edinin: Hizmet koruma API'si sınırları.

Important

Olay bir ödeme ağ geçidi kullanıyorsa ek doğrulama adımları uygulanabilir ve etkili aktarım hızı daha düşük olabilir. Ödeme ağ geçitlerini kullanan müşteriler, belirli kurulumları için önbelleğe alma davranışını doğrulamalıdır.

  • Last updated on