Katılımcı Yaratma ve Güncelleme
Last updated
Was this helpful?
Last updated
Was this helpful?
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:
(Dış katılımcılar)
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 -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": "doe@example.com",
"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": "doe2@example.com",
"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"
}
]
'Ö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": "non-existent@example.com",
"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": "44EF7B95-81B0-419D-BB0D-DFBD545F6008@example.com",
"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": "atakan@example.com",
"role": "a",
"mobile": "+905314237888",
"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": "doe@example.com",
"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": "doe2@example.com",
"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"
}
}
]
}