Token Whitelist'ine Grup Ekle
Bir tokenın whitelist'ine bir KYC grubu bağlar.
Asenkron çalışır: bağlantı hemen kaydedilir ve Token Whitelist Gruplarını Listele içinde görünür; zincir üzerindeki çağrı kuyruğa alınır. Platform sahibi düğümde 51 (AddKycGroupTokenToWhitelist) tipinde bir düğüm işlemi olarak kaydedilir ve internal_id bağlantının id değeridir; bkz. Asenkron yazma işlemleri.
Zincir, grubu belirttiğiniz setup'ın KYC tokenındaki sayısal group_id değeriyle tanır; bu yüzden yalnızca o KYC tokenında bulunan bir grubu bağlayın: API grubun var olduğunu kontrol eder, hangi tokenda olduğunu kontrol etmez. Grup id'leri yalnızca platform sahibi düğümün okuyabildiği KYC Gruplarını Listele endpoint'inden gelir.
Tokenın kendi setup_id değerini gönderin (Token Getir yanıtından): çağrı, o setup'ın bağlı olduğu KYC tokenında çalışır ve o KYC tokenının sahip cüzdanı tarafından imzalanır. Düğümünüz tokenın düğümü ya da onun üst düğümlerinden biri olmalıdır.
Gerekli izin: kyc:token:whitelist-group:create
İstek
POST /v2/admin/tokens/{token_id}/kyc/whitelist/groups/{group_id}
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Zorunlu. Varlık tokenının id'si |
group_id | string | path | Zorunlu. KYC grubunun 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 |
|---|---|---|---|
setup_id | string | Evet | Grubun bağlanacağı KYC tokenını belirleyen setup: tokenın kendi setup_id değeri |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/tokens/68ae06cfcccf4e8fc19362d1/kyc/whitelist/groups/68d2e7a9c1b4f30045e1a9b2' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"setup_id": "68b1c2d3e4f5a6b7c8d9e0f1"
}'
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 |
| 400 | 10016 | token_id geçerli bir id değil |
| 400 | 10001 (domain 5) | Token bulunamadı |
| 403 | 10005 (domain 2) | Token, düğümünüzün alt ağacı dışındaki bir düğüme ait |
| 400 | 20001001 | KYC grubu bulunamadı |
| 400 | 10015 | setup_id bir setup'a karşılık gelmiyor ya da setup'ın ağı veya KYC tokenı yok (hangisi olduğunu message söyler) |
| 500 | 10000 | Grup bu listeye zaten bağlı |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.