Ana içeriğe geç

Cüzdansız Kullanıcı Aktarımı (Toplu)

Tek bir istekte en fazla 500 kullanıcıyı sisteme aktarır; cüzdanlar her satır için asenkron olarak üretilir. Hatalar satır bazında raporlanır — bireysel satırlar atlansa bile isteğin kendisi HTTP 200 ile başarılı döner.

İstek

POST /v2/users/users/migrate/without-wallet/bulk

Başlıklar

AdAçıklama
AuthorizationGerekli. Kimlik doğrulama için Bearer token
Content-TypeGerekli. application/json olmalı

İstek Gövdesi

AlanTipAçıklama
usersarrayGerekli. 1–500 arası kullanıcı nesnesi. Her nesne tekil endpoint şeması ile aynıdır.

Örnek

curl --location '{{baseUrl}}/v2/users/users/migrate/without-wallet/bulk' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
"users": [
{ "email": "classic@example.com", "name": "Classic", "surname": "User" },
{ "external_id": "EXT-A", "kyc_sent": true },
{ "external_id": "EXT-B", "email": "hybrid@example.com" }
]
}'

Yanıt

Durum Kodu: 200 OK

{
"total": 3,
"success": 3,
"skipped": 0,
"failed": 0,
"results": [
{
"email": "classic@example.com",
"user_id": "6913872755654191dede37da",
"status": "created"
},
{
"external_id": "EXT-A",
"user_id": "6913872755654191dede37db",
"status": "created"
},
{
"external_id": "EXT-B",
"email": "hybrid@example.com",
"user_id": "6913872755654191dede37dc",
"status": "created"
}
]
}

Her results[] girişi cüzdanlı bulk endpoint sayfasında belgelenen yapının aynısını kullanır.

Olası reason Değerleri

ReasonAnlam
missing_email_and_external_idSatırda tanımlayıcılardan hiçbiri yoktu.
duplicate_emailAynı email'e sahip kullanıcı zaten var.
duplicate_external_idAynı external_id değerine sahip kullanıcı zaten var.
serbest metinOluşturma veya yayınlama sırasında beklenmeyen hata.

Not: duplicate_wallet bu akışta geçerli değildir — cüzdan, kullanıcı oluşturulduktan sonra üretilir.

Durum Kodları

Durum KoduAçıklama
200Başarılı — satır bazlı sonuçlar döner.
400Hatalı İstek — boş dizi veya > 500 satır.
401Yetkisiz — Geçersiz veya eksik kimlik doğrulama token'ı.
500Sunucu hatası.