Ağları Listele
Platformun ağ kataloğunun bir sayfasını EVM zincir id'sine (network_id) göre artan sırada döndürür. Her satır ağın kimliğini, ait olduğu zinciri ve yerel para biriminin görüntüleme alanlarını taşır. Listeyi chain_id ile tek bir zincire daraltın; zincir kapsamlı bir ağ seçicisinin ihtiyaç duyduğu liste budur.
Gerekli izin: node:summary:view
network_id kullanımı
Bu katalogdaki bir ağın id'si, her istek gövdesinin network_id olarak gönderdiği değerdir. 24 karakterlik bir hex id'dir, EVM zincir id'si değildir: Polygon bir istekte "6740e0a20000000000000102" olarak gönderilir; 137 yalnızca buradaki network_id alanıdır.
- Ağı her zaman çağıran seçer. Zincir üzerinde imza atan her işlem, çalışacağı ağı ve imzalayan cüzdanı istekten alır: düğüm kurulumu deploy etmek (
POST /v2/admin/nodes/{node_id}/setups), ödeme token'ı oluşturmak (POST /v2/admin/currency-tokens), KYC token'ı oluşturmak (POST /v2/admin/kyc-tokens), düğüm ya da kullanıcı çekimi (POST /v2/admin/nodes/{node_id}/withdraw,POST /v2/users/{user_id}/withdraw) hemnetwork_idhemwallet_idister. - Ağ hiçbir zaman sunucu tarafında türetilmez. API ağı düğümden almaz ve düğümün zincirde tek bir cüzdanı olsa bile sizin yerinize cüzdan seçmez. Eksik
network_idya dawallet_id10015ile reddedilir; ağın zincirinde olmayan bir cüzdan da reddedilir. - Ağını zaten belirten bir kayıt onu korur. Token bir kurulum, yani bir (cüzdan, ağ) çifti üzerinde oluşturulur:
POST /v2/admin/tokens,setup_idile birlikte kurulumun ağıyla eşleşmesi gereken birnetwork_idalır. Token'ın sonraki zincir üstü işlemleri bu ağda çalışır; token üzerindeki kullanıcı işlemleri (alım, satış, yakma, talep) yine kullanıcının imzalayan cüzdanınıwallet_idile belirtir. - Cüzdanlar bir ağa değil, bir zincire aittir. Tek bir cüzdan zincirinin her ağında imza atar. Düğüm cüzdanı oluşturmak (
POST /v2/admin/nodes/{node_id}/wallets) ağ yerine zincir seçilen tek yerdir: cüzdan zincirindefault_network_idağında oluşturulur (bkz. Zincirleri Listele).
Birkaç okuma uç noktası network_id adı altında sayısal EVM zincir id'sini kullanır: Gas Ücretini Getir onu query parametresi olarak alır, dağıtım token'ı okumaları da onu döndürür. Bu sayfalar bunu ayrıca belirtir.
İstek
GET /v2/networks
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
page | integer | query | Zorunlu. Sayfa numarası, 1'den başlar |
per_page | integer | query | Zorunlu. Sayfa başına öğe, 1–100 |
chain_id | string | query | Yalnızca bu zincirin ağları (Zincirleri Listele uç noktasındaki zincir id'si, 24 karakterlik hex) |
name | string | query | Ağ adında büyük/küçük harf duyarsız "içerir" araması |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request GET \
--url '{{baseUrl}}/v2/networks?page=1&per_page=25&chain_id=6740e0a10000000000000101' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"data": [
{
"id": "6740e0a20000000000000101",
"chain_id": "6740e0a10000000000000101",
"network_id": 1,
"name": "Ethereum",
"slug": "ethereum",
"logo_url": "https://s3.tokenizationtr.com/networks/ethereum-mainnet.png",
"native_currency_symbol": "ETH",
"native_currency_logo_url": "https://s3.tokenizationtr.com/currencies/eth.svg",
"native_currency_decimals": 18
},
{
"id": "6740e0a20000000000000102",
"chain_id": "6740e0a10000000000000101",
"network_id": 137,
"name": "Polygon",
"slug": "polygon",
"logo_url": "https://s3.tokenizationtr.com/networks/polygon-mainnet.png",
"native_currency_symbol": "POL",
"native_currency_logo_url": "https://s3.tokenizationtr.com/currencies/pol.svg",
"native_currency_decimals": 18
}
],
"total": 2,
"page": 1,
"per_page": 25
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
data | array | Bu sayfadaki ağlar |
data[].id | string | Ağ id'si. İstek gövdelerinin network_id olarak gönderdiği değer budur |
data[].chain_id | string | Ağın ait olduğu zincirin id'si |
data[].network_id | integer | EVM zincir id'si (örn. 1 Ethereum, 137 Polygon) |
data[].name | string | Görünen ad |
data[].slug | string | Makine adı (örn. polygon) |
data[].logo_url | string | Ağ logosu URL'si |
data[].native_currency_symbol | string | Gas ücretini ödeyen yerel para biriminin sembolü (örn. ETH, POL) |
data[].native_currency_logo_url | string | Yerel para birimi logosu URL'si |
data[].native_currency_decimals | integer | Yerel para biriminin ondalık basamak sayısı |
total | integer | Filtrelere uyan ağ sayısı |
page | integer | İstekteki sayfa numarası |
per_page | integer | İstekteki sayfa boyutu |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | page ya da per_page eksik veya aralık dışında — details alanına bakın |
| 400 | 10016 | chain_id geçerli bir 24 karakterlik hex id değil |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.