✍️Katılımcı Yaratma ve Güncelleme

Katılımcıları oluşturmak ve güncellemek için, istek gövdesinde en az bir katılımcı nesnesi içeren bir JSON dizisi bulunmalıdır. Nesneler şu tipte olabilir:

• UpsertFromUser

• UpsertByEmail (Dış katılımcılar)

• UpdateByAttendanceCode

Bir oturumdaki tüm katılımcılar için, bir katılımcının e-postası ve kullanıcı kılavuz numarası (eğer uygulanabilirse) benzersiz olmalıdır.

Example Request:

Tek bir istekte birden fazla katılımcı nesnesi (hem oluşturma hem de güncelleme işlemleri) desteklendiğinden, döngü içinde tekil API çağrıları yapmaktan kaçının.

Aşağıdaki istek, mümkün olan tüm nesnelerin kullanımını göstermektedir:

CURL

curl -L -X POST 'https://<DOMAIN>/xapi/v2/session/:SESSION_GUID/attendee/batch' \
--data-raw '
[
  // Bir kullanıcı kılavuz numarası (user_guid) kullanarak katılımcıyı ekleyebilir veya güncelleyebilirsiniz, bu işlem kullanıcının e-posta, mobil ve rol gibi tüm değişkenlerini katılımcıya aktaracaktır (rol gönderildiğinde mevcut rolün üzerine yazılır)
   // Bu yanıt, ekleme işlemini gösterecektir
 {
 "user_guid": "44EF7B95-81B0-419D-BB0D-DFBD545F6008"
 },
  // Bir kullanıcı kılavuz numarası (user_guid) kullanarak katılımcıyı ekleyebilir veya güncelleyebilirsiniz, bu işlem kullanıcının e-posta, mobil ve rol gibi tüm değişkenlerini katılımcıya aktaracaktır (rol gönderildiğinde mevcut rolün üzerine yazılır)
   // Bu yanıt, güncelleme işlemini gösterecektir
 {
 "user_guid": "7fd2b7ab-dfbe-4b35-a217-ec11791a4a80",
 "role": "a"
 },
  // Mevcut olmayan bir kullanıcı kılavuz numarası reddedilecektir
 {
 "user_guid": "7fd2b7ab-dfbe-4b35-a217-ec11791a4a8x"
 },
  // E-posta, ad, soyad ve rol ile bir kullanıcıyı ekleyebilir veya güncelleyebilirsiniz (rol belirtilmezse varsayılan olarak 'u' olur)
  // Harici katılımcıları (sistemde kayıtlı olmayan katılımcıları) eklemek için doğru format budur
  // Yanıt, ekleme işlemini gösterecektir
 {
 "email": "[email protected]",
 "name": "John",
 "surname": "Doe",
 "role": "e"
 },
  // E-posta, ad, soyad ve rol ile bir kullanıcıyı ekleyebilir veya güncelleyebilirsiniz (rol belirtilmezse varsayılan olarak 'u' olur)
  // Yanıt, güncelleme işlemini gösterecektir
 {
 "email": "[email protected]",
 "name": "updated_name",
 "surname": "Doe",
 "role": "u"
 },
  // Mevcut bir katılımcıyı katılım kodu ile güncelleyebilirsiniz
 {
 "attendance_code": "5786FF4C-4A93-45A2-BAF1-9461F376E8C5",
 "role": "e"
 },
  // Mevcut olmayan katılım kodu reddedilecektir
 {
 "attendance_code": "2BA64ED7-EE65-4164-A0A0-85A45E8D0BFx",
 "mobile": "+00 000 00 00"
 }
]
'

NodeJS

Örnek yanıt:

Bu işlemin yanıtı şu şekilde bir json nesnesi içerir:

{
    "approved": [
        // Katılımcı JSON objesi
    ],
    "rejected": [
        // Katılımcı JSON objesi
    ]
}

İşlemlerin nasıl gittiğine bağlı olarak Yanıt Durum Kodları değişecektir:

• 200 OK: Tüm işlemler başarıyla tamamlandı

• 207 Multi-Status: Kısmi başarı - bazı işlemler başarısız oldu

• 400 Bad Request: Tüm işlemler başarısız oldu

{
    "approved": [
        {
            "session_id": "70826",
            "user_id": "",
            "user_guid": "",
            "attendee_id": "503735",
            "attendance_code": "5786FF4C-4A93-45A2-BAF1-9461F376E8C5",
            "name": "non-existent",
            "surname": "non-existent",
            "email": "[email protected]",
            "role": "e",
            "mobile": null,
            "creation_date": "2024-10-18T21:39:21.575387+03:00",
            "updating_date": "2024-10-18T21:39:39.070343+03:00",
            "operation": "updated"
        },
        {
            "session_id": "70826",
            "user_id": "8208",
            "user_guid": "44EF7B95-81B0-419D-BB0D-DFBD545F6008",
            "attendee_id": "503736",
            "attendance_code": "F344309A-BA6C-4D92-9C5A-4F2EE65AFB34",
            "name": "logar",
            "surname": "komutan",
            "email": "[email protected]",
            "role": "a",
            "mobile": "",
            "creation_date": "2024-10-18T21:39:39.125758+03:00",
            "updating_date": "2024-10-18T21:39:39.125758+03:00",
            "operation": "inserted"
        },
        {
            "session_id": "70826",
            "user_id": "4490",
            "user_guid": "7fd2b7ab-dfbe-4b35-a217-ec11791a4a80",
            "attendee_id": "503725",
            "attendance_code": "D1CCAE51-7B5B-4885-A10B-8B30DFA5F014",
            "name": "Atakan",
            "surname": "Bodur",
            "email": "[email protected]",
            "role": "a",
            "mobile": "[phone]",
            "creation_date": "2024-10-18T21:31:19.692427+03:00",
            "updating_date": "2024-10-18T21:39:39.125758+03:00",
            "operation": "updated"
        },
        {
            "session_id": "70826",
            "user_id": "0",
            "user_guid": null,
            "attendee_id": "503738",
            "attendance_code": "27A9E30B-48C3-4933-9E15-6752D686AB51",
            "name": "John",
            "surname": "Doe",
            "email": "[email protected]",
            "role": "e",
            "mobile": null,
            "creation_date": null,
            "updating_date": null,
            "operation": "inserted"
        },
        {
            "session_id": "70826",
            "user_id": "0",
            "user_guid": null,
            "attendee_id": "503726",
            "attendance_code": "C937F71E-DE23-463E-A3CE-3DCB3F36830D",
            "name": "updated_name",
            "surname": "Doe",
            "email": "[email protected]",
            "role": "u",
            "mobile": null,
            "creation_date": null,
            "updating_date": null,
            "operation": "updated"
        }
    ],
    "rejected": [
        {
            "model": {
                "session_id": "70826",
                "user_id": "",
                "user_guid": "",
                "attendee_id": "-1",
                "attendance_code": "",
                "name": null,
                "surname": null,
                "email": null,
                "role": null,
                "mobile": "+00 000 00 00",
                "creation_date": null,
                "updating_date": null,
                "operation": "error"
            },
            "state": {
                "code": 12,
                "details": "Attendee not found"
            }
        },
        {
            "model": {
                "session_id": "-1",
                "user_id": "",
                "user_guid": "7fd2b7ab-dfbe-4b35-a217-ec11791a4a8x",
                "attendee_id": "-1",
                "attendance_code": "",
                "name": null,
                "surname": null,
                "email": null,
                "role": null,
                "mobile": null,
                "creation_date": null,
                "updating_date": null,
                "operation": "error"
            },
            "state": {
                "code": 12,
                "details": "Attendee not found"
            }
        }
    ]
}