Token Oluştur
Bir node ve distributor için yeni bir token oluşturun.
Endpoint: POST /api/v1/integration/tokens/nodes/{node_id}/distributors/{distributor_id}
Kimlik Doğrulama: Gerekli (Bearer token)
Gerekli Header'lar:
Authorization: Bearer <access_token>
X-Target-Server: integration
Content-Type: application/json
Yol Parametreleri
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
node_id | string (UUID) | Evet | Node ID |
distributor_id | string (UUID) | Evet | Distributor ID |
İstek Gövdesi
{
"name": "My Token",
"symbol": "MTK",
"description": "This is a sample token description",
"chain_id": 1,
"value": 100.50,
"supply": 1000000,
"external_id": "ext_token_12345",
"contract": {
"address": "0x1234567890123456789012345678901234567890",
"hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
},
"rules": {
"max_purchase_limit": 10000,
"min_purchase_limit": 100
},
"status": 2,
"integration": {
"chain_id": 1,
"abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
"contract_address": "0x9876543210987654321098765432109876543210",
"function_name": "transfer",
"currency_token_address": "0x1111111111111111111111111111111111111111",
"is_approved": true,
"args": [
{
"type": "address",
"value": "0x2222222222222222222222222222222222222222",
"description": "Recipient address"
},
{
"type": "uint256",
"value": "1000000000000000000",
"description": "Amount to transfer"
}
]
},
"currency_token_address": "0x1111111111111111111111111111111111111111",
"currency_token_symbol": "USDT",
"currency_token_decimals": 18,
"currency_token_name": "Tether USD",
"meta": {
"images": [
{
"url": "https://example.com/images/token-logo.png",
"is_default": true,
"hash": "abc123def456"
},
{
"url": "https://example.com/images/token-banner.jpg",
"is_default": false,
"hash": "def456ghi789"
}
],
"documents": [
{
"name": "Whitepaper",
"url": "https://example.com/documents/whitepaper.pdf",
"type": 2,
"hash": "whitepaper_hash_123"
},
{
"name": "Terms of Service",
"url": "https://example.com/documents/terms.pdf",
"type": 3,
"hash": "terms_hash_456"
}
]
}
}
İstek Parametreleri
| Alan | Tip | Gerekli | Açıklama |
|---|---|---|---|
name | string | Evet | Token adı |
symbol | string | Evet | Token sembolü |
description | string | Hayır | Token açıklaması |
chain_id | integer | Evet | Blockchain ağ kimliği |
value | number | Evet | Token değeri |
supply | integer | Evet | Toplam token arzı |
external_id | string | Hayır | External token tanımlayıcısı |
contract | object | Hayır | Contract bilgileri |
contract.address | string | Hayır | Contract adresi |
contract.hash | string | Hayır | Contract hash'i |
rules | object | Hayır | Satın alma kuralları |
rules.max_purchase_limit | integer | Hayır | Maksimum satın alma limiti |
rules.min_purchase_limit | integer | Hayır | Minimum satın alma limiti |
status | integer | Evet | Token durumu |
integration | object | Hayır | Entegrasyon yapılandırması |
integration.chain_id | integer | Hayır | Entegrasyon chain ID'si |
integration.abi | string | Hayır | Contract ABI (JSON string) |
integration.contract_address | string | Hayır | Entegrasyon contract adresi |
integration.function_name | string | Hayır | Çağrılacak fonksiyon adı |
integration.currency_token_address | string | Hayır | Currency token adresi |
integration.is_approved | boolean | Hayır | Contract'ın onaylanıp onaylanmadığı |
integration.args | array | Hayır | Fonksiyon argümanları |
integration.args[].type | string | Hayır | Argüman tipi |
integration.args[].value | string | Hayır | Argüman değeri |
integration.args[].description | string | Hayır | Argüman açıklaması |
currency_token_address | string | Hayır | Currency token adresi |
currency_token_symbol | string | Hayır | Currency token sembolü |
currency_token_decimals | integer | Hayır | Currency token ondalık basamak sayısı |
currency_token_name | string | Hayır | Currency token adı |
meta | object | Hayır | Metadata (resimler ve belgeler) |
meta.images | array | Hayır | Token resimleri |
meta.images[].url | string | Hayır | Resim URL'i |
meta.images[].is_default | boolean | Hayır | Bu resmin varsayılan olup olmadığı |
meta.images[].hash | string | Hayır | Resim hash'i |
meta.documents | array | Hayır | Token belgeleri |
meta.documents[].name | string | Hayır | Belge adı |
meta.documents[].url | string | Hayır | Belge URL'i |
meta.documents[].type | integer | Hayır | Belge tipi |
meta.documents[].hash | string | Hayır | Belge hash'i |
Yanıt
Durum: 201 Created
Tam detaylarla oluşturulan token nesnesini döndürür.
{
"id": "4c3e2fd0-cbed-4c01-aad5-e39fa9e17fa4",
"node_id": "e40efce4-38a3-46c4-a202-e8db95d0409c",
"distributor_id": "084a5159-1546-4ade-a7ba-956e0234a417",
"currency_token_id": "c94c94fc-479d-4d08-bba0-123a210c174c",
"chain_id": 1,
"name": "My Token",
"description": "This is a sample token description",
"symbol": "MTK",
"value": 100.5,
"supply": 1000000,
"external_id": "ext_token_12345",
"contract": {
"address": "0x1234567890123456789012345678901234567890",
"hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
},
"rules": {
"max_purchase_limit": 10000,
"min_purchase_limit": 100
},
"status": 2,
"integration": {
"chain_id": 1,
"abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
"contract_address": "0x9876543210987654321098765432109876543210",
"function_name": "transfer",
"currency_token_address": "0x1111111111111111111111111111111111111111",
"is_approved": true,
"args": [
{
"type": "address",
"value": "0x2222222222222222222222222222222222222222",
"description": "Recipient address"
},
{
"type": "uint256",
"value": "1000000000000000000",
"description": "Amount to transfer"
}
]
},
"meta": {
"images": [
{
"id": "073a551e-583f-498d-8b2f-c8d088995d30",
"url": "https://example.com/images/token-logo.png",
"is_default": true,
"hash": "abc123def456",
"created_at": "2025-12-24T10:05:48.503461Z"
},
{
"id": "c89102a7-ded1-4d97-b503-d85af888ffc8",
"url": "https://example.com/images/token-banner.jpg",
"is_default": false,
"hash": "def456ghi789",
"created_at": "2025-12-24T10:05:48.504681Z"
}
],
"documents": [
{
"id": "56a00061-8336-4009-9247-01eaad054e7c",
"name": "Whitepaper",
"url": "https://example.com/documents/whitepaper.pdf",
"type": 2,
"hash": "whitepaper_hash_123",
"created_at": "2025-12-24T10:05:48.505861Z"
},
{
"id": "fc7a8a2a-7e35-4169-9293-0f272c1fb0eb",
"name": "Terms of Service",
"url": "https://example.com/documents/terms.pdf",
"type": 3,
"hash": "terms_hash_456",
"created_at": "2025-12-24T10:05:48.50757Z"
}
]
},
"created_at": "2025-12-24T13:05:48.496502+03:00",
"updated_at": "2025-12-24T13:05:48.496502+03:00"
}
Örnek cURL İsteği
curl -X POST 'https://<base-url>/api/v1/integration/tokens/nodes/e40efce4-38a3-46c4-a202-e8db95d0409c/distributors/084a5159-1546-4ade-a7ba-956e0234a417' \
-H "Content-Type: application/json" \
-H "X-Target-Server: integration" \
-H "Authorization: Bearer <access_token>" \
-d '{
"name": "My Token",
"symbol": "MTK",
"description": "This is a sample token description",
"chain_id": 1,
"value": 100.50,
"supply": 1000000,
"external_id": "ext_token_12345",
"contract": {
"address": "0x1234567890123456789012345678901234567890",
"hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
},
"rules": {
"max_purchase_limit": 10000,
"min_purchase_limit": 100
},
"status": 2,
"integration": {
"chain_id": 1,
"abi": "[{\"inputs\":[],\"name\":\"transfer\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]",
"contract_address": "0x9876543210987654321098765432109876543210",
"function_name": "transfer",
"currency_token_address": "0x1111111111111111111111111111111111111111",
"is_approved": true,
"args": [
{
"type": "address",
"value": "0x2222222222222222222222222222222222222222",
"description": "Recipient address"
},
{
"type": "uint256",
"value": "1000000000000000000",
"description": "Amount to transfer"
}
]
},
"currency_token_address": "0x1111111111111111111111111111111111111111",
"currency_token_symbol": "USDT",
"currency_token_decimals": 18,
"currency_token_name": "Tether USD",
"meta": {
"images": [
{
"url": "https://example.com/images/token-logo.png",
"is_default": true,
"hash": "abc123def456"
},
{
"url": "https://example.com/images/token-banner.jpg",
"is_default": false,
"hash": "def456ghi789"
}
],
"documents": [
{
"name": "Whitepaper",
"url": "https://example.com/documents/whitepaper.pdf",
"type": 2,
"hash": "whitepaper_hash_123"
},
{
"name": "Terms of Service",
"url": "https://example.com/documents/terms.pdf",
"type": 3,
"hash": "terms_hash_456"
}
]
}
}'