Cüzdanlı Kullanıcı Aktarımı (CSV)
Zaten bir adresi olan kullanıcıları yüklenen bir CSV dosyasından aktarır. Satırlar toplu endpoint gibi işlenir ve yanıt aynı biçimdedir. Sınırlar: dosya en fazla 5 MB, en fazla 500 veri satırı.
CSV satırları JSON endpoint'lerinin uyguladığı istek doğrulamasından (e-posta biçimi, zorunlu değerler) geçmez; bu yüzden dosyayı yüklemeden önce kontrol edin: her satırda boş olmayan bir wallet_address ve chain_id bulunmalıdır.
Gerekli izin: user:create
İstek
POST /v2/users/migrate/with-wallet/csv
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Content-Type | Zorunlu. multipart/form-data |
Gövde
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
file | file | Evet | CSV dosyası (multipart form alanı). İlk satır başlıktır |
CSV biçimi
Başlık wallet_address ve chain_id içermelidir; diğer her sütun isteğe bağlıdır ve dosyada hiç bulunmayabilir. Başlık adları büyük/küçük harf duyarsız eşleşir, sütun sırası önemli değildir, UTF-8 BOM tolere edilir ve değerler kırpılır.
| Sütun | Zorunlu | Notlar |
|---|---|---|
wallet_address | Evet | Küçük harfle saklanır |
chain_id | Evet | Adresin bulunduğu zincir (chains ID'si) |
external_id | Hayır | email boşsa zorunlu |
email | Hayır | external_id boşsa zorunlu |
name | Hayır | Boşsa saklanmaz |
surname | Hayır | Boşsa saklanmaz |
kyc_sent | Hayır | Varsayılan false. true, 1, yes, y (büyük/küçük harf fark etmez) doğru kabul edilir |
Klasik mod:
email,name,surname,wallet_address,chain_id,kyc_sent
john@example.com,John,Doe,0xAbCdEf0123456789ABCDEF0123456789ABCDEF01,6740e0a10000000000000101,false
KVKK modu (kişisel veri yok):
external_id,wallet_address,chain_id,kyc_sent
EXT-1042,0xAbCdEf0123456789ABCDEF0123456789ABCDEF01,6740e0a10000000000000101,true
EXT-1043,0x2222222222222222222222222222222222222222,6740e0a10000000000000101,false
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/users/migrate/with-wallet/csv' \
--header 'Authorization: Bearer <access_token>' \
--form 'file=@./users.csv'
Yanıt
Toplu endpoint ile aynı biçimde.
{
"total": 2,
"success": 2,
"skipped": 0,
"failed": 0,
"results": [
{ "external_id": "EXT-1042", "user_id": "6913872755654191dede37da", "status": "created" },
{ "external_id": "EXT-1043", "user_id": "6913872755654191dede37db", "status": "created" }
]
}
Hatalar
Hepsi 400 ve 10015 kodludur; message sorunu belirtir.
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | file is required: file form alanı eksik |
| 400 | 10015 | file too large: 5 MB'tan büyük |
| 400 | 10015 | csv header is required: ilk satır okunamadı |
| 400 | 10015 | missing csv column: wallet_address / missing csv column: chain_id |
| 400 | 10015 | csv exceeds row limit: 500'den fazla veri satırı |
| 400 | 10015 | csv has no rows: yalnızca başlık var |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.