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

En fazla 500 kullanıcıyı tek istekte aktarır; oluşturulan her kullanıcı için asenkron olarak bir custody cüzdanı oluşturulur. Her satır tekil endpoint gibi işlenir ve ayrı raporlanır: bazı satırlar atlansa ya da başarısız olsa bile istek 200 döner. Önce tüm satırlar doğrulanır; geçersiz tek bir satır (örneğin chain_id eksik) isteğin tamamını reddeder.

chain_id değeri çözümlenemeyen bir satır user_id olmadan failed olarak raporlanır, ancak kullanıcısı (cüzdansız olarak) zaten kaydedilmiştir. Satırı tekrar çalıştırmak yerine cüzdanı Kullanıcı Cüzdanı Oluştur ile ekleyin.

Gerekli izin: user:create

İstek

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

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
users	array	Evet	1–500 satır; her biri tekil endpoint alanlarını taşır (her satırda chain_id zorunlu)

Örnek

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

Yanıt

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

Yanıt Alanları

Cüzdanlı toplu yanıt ile aynı alanlar. skipped satırlarda reason değeri missing_email_and_external_id, duplicate_email ya da duplicate_external_id olur (duplicate_wallet ve invalid_chain bu akışta oluşmaz); failed satırlarda serbest metindir.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (boş users, 500'den fazla satır, chain_id içermeyen bir satır, hatalı email) — details alanına bakın

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.