KYC Grubuna Üye Ekle
Bir KYC grubuna tek bir adres ekler.
Asenkron çalışır: üye hemen kaydedilir ve KYC Grubu Üyelerini Listele içinde görünür; zincir üzerindeki çağrı, KYC tokenının sahip cüzdanı tarafından imzalanmak üzere kuyruğa alınır. Platform sahibi düğümde 39 (AddMemberToKycGroup) tipinde bir düğüm işlemi olarak kaydedilir ve internal_id grubun id değeridir; bkz. Asenkron yazma işlemleri.
Yalnızca platform sahibi (kök) düğüm çağırabilir.
Gerekli izin: kyc:group:member:create
İstek
POST /v2/admin/kycs/{kyc_token_id}/groups/{group_id}/members
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
kyc_token_id | string | path | Zorunlu. KYC tokenının id değeri (KYC Tokenlarını Listele yanıtından) |
group_id | string | path | Zorunlu. Grubun id değeri (24 karakterlik hex); sayısal group_id değil |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Content-Type | Zorunlu. application/json |
Gövde
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
user_address | string | Evet | Eklenecek cüzdan adresi. Gönderildiği haliyle saklanır; biçimi kontrol edilmez |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/kycs/68c4a1f2b9e3d70012a5c3e8/groups/68d2e7a9c1b4f30045e1a9b2/members' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"user_address": "0x1234567890123456789012345678901234567890"
}'
Yanıt
Durum 201.
{
"requires_approval": false,
"completed": true
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
requires_approval | boolean | Her zaman false: KYC yazma işlemlerinin onay adımı yoktur |
completed | boolean | İstek kabul edilip zincir üzerindeki çağrı kuyruğa alındığında true. Zincirin onayladığı anlamına gelmez |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız — details alanına bakın |
| 403 | 10005 (domain 2) | Düğümünüz platform sahibi (kök) düğüm değil |
| 400 | 20001001 | KYC grubu bulunamadı ya da path'te adı geçenden farklı bir KYC tokenında |
| 400 | 10015 | KYC tokenı çözümlenemedi (kyc token not found or not deployed) |
| 500 | 10000 | Adres bu grubun zaten üyesi |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.