Käytä tapahtuman ohjelmointirajapintaa reaaliaikaisilla matkoilla

Tapahtuman ohjelmointirajapinta on ohjelmallinen menetelmä, jonka avulla voit käyttää tietoja tapahtumista, istunnoista, istunnon kappaleista, passeista, puhujista ja sponsoroineista. Lisäksi tapahtuman ohjelmointirajapinnan avulla voit rekisteröityä tapahtumiin ja istuntoihin.

Käytettävä ohjelmointirajapinta on https-protokollan kautta, ja sitä käytetään ohjelmointirajapinnan päätepisteestä, jonka saat verkkosovellustunnuksen luomisen aikana. Kaikki tiedot lähetetään ja vastaanotetaan JSON-muodossa.

Rekisteröidy tapahtuman ohjelmointirajapintaan

Luo uusi verkkosovellus Tapahtumienhallinnan>Asetukset-osiossa. On tärkeää valita oikea alkuperä. Jos esimerkiksi valitset https://contoso.comvaihtoehdon , eri toimialueella isännöity JavaScript ei voi käyttää tapahtumien hallinnan ohjelmointirajapintaa.

Kun olet luonut verkkosovelluksen, näet Endpoint-dokumentaatiossa (esikatselu) linkin OpenAPI-määritykseen.

Voit valita linkin sekä kopioida ja liittää ohjelmointirajapintasopimuksen OpenAPI-editoriin, kuten Swagger Editoriin, joka luo automaattisesti paketit, joiden avulla voit löytää ohjelmointirajapintasi. Jotta voit käyttää ohjelmointirajapintaasi, sinulla on oltava valtuutettu käyttöoikeus (anna Tunnus-sarake ).

Tapahtumasivun tai tapahtumaportaalin luominen

Tapahtuman ohjelmointirajapinnan avulla voit luoda mukautetun tapahtumasivun ja tapahtumaportaalin, jossa luetellaan kaikki saatavilla olevat tapahtumat, jotka ovat reaaliaikaisia ja julkaistuja käyttämällä Mukautettu ratkaisu tapahtuman ohjelmointirajapinnan avulla -julkaisuvaihtoehtoa. Tapahtuman ohjelmointirajapinnan avulla voit tehdä seuraavaa:

• Nouda live-tapahtumien luettelo, joka sisältää niiden nimen, kuvauksen, sijainnin ja ajan.
• Tapahtuman sivulla sen avulla voit noutaa tapahtuman avaintietoja, kuten:
  • Nimi
  • Aika
  • Sijainti
  • Tapahtuman QR-koodi
  • Kapasiteetti
  • Luettelo istunnoista
  • Puhujaluettelo
  • Luettelo sponsoreista ja heidän logoistaan

Mukautetun tapahtuman rekisteröintikokemuksen luominen

Tapahtuman ohjelmointirajapinnan avulla voit myös luoda rekisteröintiä koskevan lähetyksen käyttämättä reaaliaikaisia markkinointilomakkeita, mutta voit silti hyötyä tärkeistä ominaisuuksista, kuten vastaavasta strategiasta, suostumuksesta, yleisöasetuksista ja muista.

Määritä ensin tärkeimmät asetukset yleisöllesi siirtymällä kohtaan Asetukset>Tapahtuman hallinta>Tapahtuman rekisteröintiasetukset ja määritä:

1. Oletusryhmä
2. Oletusvastaavuussääntö
3. Yhteensopivuusprofiilin oletusasetus

Tapahtuman rekisteröintiasetusten oletusasetuksia käytetään, kun käsitellään ohjelmointirajapinnan lähetyksiä. Kun olet määrittänyt rekisteröintiasetukset, tapahtuman ohjelmointirajapinnan lähetyksen päätepisteen avulla voit:

1. Luo tapahtuman rekisteröinnin lähetys:

{ 
    "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" 
                } 
            ] 
        } 
    ] 
}

2. Rekisteröinnin lähettäminen istuntoa varten:

{ 
    "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" 
                } 
            ] 
        } 
    ] 
} 

3. Luo odotusluettelon rekisteröinti:

{
    "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" 
                } 
            ] 
        } 
    ]
}

Suorituskyky ja rajoitukset

Tapahtuman ohjelmointirajapinta tukee suuren volyymin rekisteröintiskenaarioita asynkronisen prosessoinnin, älykkään välimuistitallennuksen ja sisäänrakennetun uudelleenyritysten logiikan avulla.

Kun rekisteröintipyyntö saapuu tapahtuman ohjelmointirajapinnan kautta, järjestelmä:

• Vahvistaa, että tapahtuma on aktiivinen ja että kaikki liittyvät entiteetit ovat kelvolliset
• Palauttaa soittajalle välittömän onnistumisvastauksen.
• Käynnistää työnimikkeen taustakäsittelyn luodaksesi tapahtuman rekisteröinnin ja siihen liittyvät entiteetit asynkronisesti.

Välimuistiin tallentamisen toiminta

Lue välimuisti: Järjestelmä käyttää 10 minuutin välimuistia tapahtuman ja entiteetin vahvistusta varten. Tämä vähentää Dataverseen tarpeetonta lukemista ja parantaa siirtomäärää kuormituksesta.

Note

Lukuvälimuisti vaikuttaa vain vahvistukseen, ei itse rekisteröintitietueisiin.

Uudelleenyritysten logiikka ja virheiden käsittely

Jos taustakäsittely ei luo tapahtuman rekisteröintiä, järjestelmä yrittää rekisteröityä uudelleen automaattisesti enintään kuuden tunnin ajan. Tämä koskee synkronisia ja asynkronisia virhetilanteita, joilla varmistetaan tietojen luotettavuus ilman manuaalisia toimia.

Siirtomäärän ja Dataversen rajoitukset

Muotottomien rekisteröintiskenaarioiden ensisijainen rajoittava tekijä on lipunrekisteröintien entiteettien luontihinta Dataversessa. Normaalissa olosuhteissa Dataverse valvoo 6 000 ohjelmointirajapintapyynnön rajaa viiden minuutin liukuvan ikkunan sisällä käyttäjää ja verkkopalvelinta kohti. Ympäristö voi palauttaa 429 Too Many Requests virheen, jos nämä rajat ylitetään. Lisätietoja: Palvelun suojauksen ohjelmointirajapinnan rajoitukset.

Important

Jos tapahtuma käyttää maksuyhdyskäytävää, lisätarkistusvaiheita voi soveltaa ja tehokas siirtomäärä voi olla pienempi. Asiakkaiden, jotka käyttävät maksuyhdyskäytäviä, on vahvistettava välimuistiin tallentamisen toiminta tiettyä määritystä varten.