ใช้ API เหตุการณ์ในการเดินทางแบบเรียลไทม์

Event API คือวิธีการเข้าถึงข้อมูลผ่านโปรแกรมจากอีเวนต์ เซสชัน แทร็กเซสชัน บัตรผ่าน วิทยากร และสิทธิ์การสนับสนุน นอกจากนี้ API เหตุการณ์ช่วยให้คุณสามารถลงทะเบียนสําหรับเหตุการณ์และเซสชันได้

API ที่เข้าถึงได้ผ่านโปรโตคอล HTTPS และเข้าถึงได้จากจุดสิ้นสุด API ที่คุณได้รับขณะสร้างโทเค็นแอปพลิเคชันเว็บ ข้อมูลทั้งหมดจะถูกส่งและรับเป็น JSON

ลงทะเบียนสำหรับ API อีเวนต์

ในส่วนการตั้งค่าภายใต้การจัดการ>เหตุการณ์เว็บแอปพลิเคชัน สร้างเว็บแอปพลิเคชันใหม่ สิ่งสําคัญคือการเลือกจุดเริ่มต้นที่ถูกต้อง ตัวอย่างเช่น ถ้าคุณเลือก https://contoso.comJavaScript ที่โฮสต์บนโดเมนอื่นจะไม่สามารถเข้าถึง API การจัดการเหตุการณ์ได้

หลังจากที่คุณสร้างเว็บแอปพลิเคชัน คุณจะเห็นลิงก์ไปยังข้อมูลจําเพาะของ OpenAPI ในเอกสารประกอบปลายทาง (ตัวอย่าง)

คุณสามารถเลือกลิงก์และคัดลอกและวางสัญญา API ไปยังตัวแก้ไข OpenAPI เช่น Swagger Editor ซึ่งจะสร้าง Wrapper ที่คุณสามารถใช้เพื่อค้นหา API ของคุณโดยอัตโนมัติ หากต้องการเข้าถึง API ของคุณ คุณต้องได้รับอนุญาต (ระบุคอลัมน์ Token )

สร้างหน้าเหตุการณ์หรือพอร์ทัลเหตุการณ์

API เหตุการณ์ช่วยให้คุณสามารถสร้างหน้าเหตุการณ์แบบกําหนดเองและพอร์ทัลเหตุการณ์ที่แสดงรายการเหตุการณ์ที่พร้อมใช้งานทั้งหมดที่มีการถ่ายทอดสดและเผยแพร่โดยใช้ตัวเลือกการเผยแพร่ "โซลูชันแบบกําหนดเองโดยใช้ API เหตุการณ์" API เหตุการณ์ช่วยให้คุณสามารถ:

• เรียกใช้รายการของเหตุการณ์ถ่ายทอดสดที่ประกอบด้วยชื่อ คําอธิบาย ตําแหน่งที่ตั้ง และเวลา
• สําหรับหน้าเหตุการณ์ จะช่วยให้คุณสามารถดึงข้อมูลสําคัญเกี่ยวกับเหตุการณ์เช่น:
  • ชื่อ
  • เวลา
  • สถานที่
  • คิวอาร์โค้ดเหตุการณ์
  • กำลังการผลิต
  • รายการของเซสชัน
  • รายการลําโพง
  • รายชื่อผู้สนับสนุนและโลโก้ของพวกเขา

สร้างประสบการณ์การลงทะเบียนเหตุการณ์แบบกําหนดเอง

API เหตุการณ์ยังช่วยให้คุณสามารถสร้างการส่งการลงทะเบียนโดยไม่จําเป็นต้องใช้ฟอร์มการตลาดแบบเรียลไทม์ในขณะที่ยังคงได้รับประโยชน์จากคุณลักษณะที่สําคัญเช่นกลยุทธ์การจับคู่ความยินยอมการตั้งค่าผู้ชมและอื่น ๆ

ขั้นแรก ให้กําหนดการตั้งค่าหลักสําหรับผู้ชมของคุณโดยไปที่ การตั้งค่า>การตั้งค่าการลงทะเบียนเหตุการณ์>เหตุการณ์ และกําหนด:

1. กลุ่มเป้าหมายค่าเริ่มต้น
2. กฎการจับคู่เริ่มต้น
3. โปรไฟล์การปฏิบัติตามกฎระเบียบเริ่มต้น

การตั้งค่าการลงทะเบียนเหตุการณ์เริ่มต้นจะใช้เมื่อประมวลผลการส่งจาก API เมื่อคุณตั้งค่าการลงทะเบียน จุดสิ้นสุดการส่ง API เหตุการณ์จะช่วยให้คุณสามารถ:

1. สร้างการส่งการลงทะเบียนสําหรับเหตุการณ์:

{ 
    "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. สร้างการส่งการลงทะเบียนสําหรับเซสชัน:

{ 
    "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. สร้างการลงทะเบียนรายการรอ:

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

ประสิทธิภาพและขีดจํากัด

API เหตุการณ์สนับสนุนสถานการณ์การลงทะเบียนปริมาณมากผ่านการประมวลผลแบบอะซิงโครนัส การแคชแบบสมาร์ท และตรรกะการลองใหม่ในตัว

เมื่อคําขอลงทะเบียนมาถึงผ่าน API เหตุการณ์ ระบบ:

• ตรวจสอบว่าเหตุการณ์เปิดใช้งานอยู่และเอนทิตีที่เกี่ยวข้องทั้งหมดอยู่ในสถานะที่ถูกต้อง
• ส่งกลับการตอบสนองความสําเร็จทันทีต่อผู้โทร
• เริ่มต้นตัวประมวลผลรายการงานพื้นหลังเพื่อสร้างการลงทะเบียนเหตุการณ์และเอนทิตีที่เกี่ยวข้องแบบอะซิงโครนัส

พฤติกรรมการแคช

อ่านแคช: ระบบใช้แคช 10 นาทีสําหรับเหตุการณ์และการตรวจสอบเอนทิตี การดําเนินการนี้จะช่วยลดการอ่านค่าซ้ําซ้อนไปยัง Dataverse และปรับปรุงปริมาณงานภายใต้การโหลด

Note

แคชการอ่านมีผลต่อการตรวจสอบความถูกต้องเท่านั้น ไม่ใช่ระเบียนการลงทะเบียนด้วยตนเอง

ลองตรรกะและการจัดการความล้มเหลวอีกครั้ง

ถ้าตัวประมวลผลแบบเบื้องหลังไม่สามารถสร้างการลงทะเบียนเหตุการณ์ ระบบจะลองใหม่โดยอัตโนมัติสูงสุดหกชั่วโมง สิ่งนี้นําไปใช้กับสถานการณ์ความล้มเหลวแบบซิงโครนัสและแบบอะซิงโครนัสเพื่อให้มั่นใจถึงความน่าเชื่อถือของข้อมูลโดยไม่ต้องมีการดําเนินการด้วยตนเอง

ขีดจำกัดของอัตราการประมวลผลและ Dataverse

ปัจจัยข้อจํากัดหลักสําหรับสถานการณ์การลงทะเบียนแบบไม่เป็นทางการคืออัตราที่สามารถสร้างเอนทิตีการลงทะเบียนตั๋วใน Dataverse ได้ ภายใต้เงื่อนไขปกติ Dataverse จะบังคับใช้ขีดจํากัดของคําขอ API 6,000 รายการภายในหน้าต่างบานเลื่อนห้านาทีต่อผู้ใช้และเว็บเซิร์ฟเวอร์ แพลตฟอร์มสามารถส่งกลับข้อผิดพลาด 429 Too Many Requests ได้หากเกินขีดจํากัดเหล่านี้ เรียนรู้เพิ่มเติม: ขีดจํากัด API การป้องกันบริการ

สำคัญ

หากเหตุการณ์ดังกล่าวใช้เกตเวย์การชําระเงิน อาจใช้ขั้นตอนการตรวจสอบเพิ่มเติมและปริมาณงานที่มีผลบังคับใช้อาจต่ํากว่า ลูกค้าที่ใช้เกตเวย์การชําระเงินควรตรวจสอบพฤติกรรมการแคชสําหรับการตั้งค่าเฉพาะของพวกเขา