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
| Ad | Açıklama |
|---|---|
Authorization | Gerekli. Kimlik doğrulama için Bearer token |
Content-Type | Gerekli. application/json olmalı |
İstek Gövdesi
| Alan | Tip | Açıklama |
|---|---|---|
users | array | Gerekli. 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
| Reason | Anlam |
|---|---|
missing_email_and_external_id | Satırda tanımlayıcılardan hiçbiri yoktu. |
duplicate_email | Aynı email'e sahip kullanıcı zaten var. |
duplicate_external_id | Aynı external_id değerine sahip kullanıcı zaten var. |
| serbest metin | Oluş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 Kodu | Açıklama |
|---|---|
| 200 | Başarılı — satır bazlı sonuçlar döner. |
| 400 | Hatalı İstek — boş dizi veya > 500 satır. |
| 401 | Yetkisiz — Geçersiz veya eksik kimlik doğrulama token'ı. |
| 500 | Sunucu hatası. |