پرش به مطلب اصلی

احراز هویت API

تمام درخواست‌های ارسالی به API بلاک‌لنز (Blocklens) باید با یک کلید API احراز هویت شوند. کلیدهای API در اختیار کاربرانی قرار می‌گیرد که اشتراکی واجد شرایط داشته باشند.

ساخت کلید API​

می‌توانید کلیدهای API خود را از بخش API Keys در داشبورد حساب کاربری‌تان مدیریت کنید.

  1. به صفحه‌ی API Keys بروید.
  2. روی "Create New Key" کلیک کنید.
  3. یک نام توصیفی برای کلید خود انتخاب کنید (برای مثال، "My Trading Bot" یا "Research Script").
  4. کلید API جدید شما نمایش داده می‌شود. آن را بلافاصله کپی کرده و در جایی امن ذخیره کنید. به دلایل امنیتی، پس از آن دیگر امکان مشاهده‌ی کامل کلید وجود نخواهد داشت.

ارسال درخواست‌های احراز هویت‌شده​

برای احراز هویت درخواست‌های API، باید کلید API خود را با استفاده از روش Bearer در هدر Authorization قرار دهید.

نمونه‌ی درخواست با cURL​

curl -X GET "https://api.blocklens.co/v1/holder/supply?limit=1" \
     -H "Authorization: Bearer your_api_key_here"

نمونه‌ی درخواست با Python

import requests

API_KEY = "your_api_key_here"
API_URL = "https://api.blocklens.co/v1/holder/supply"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

params = {
    "limit": 1
}

response = requests.get(API_URL, headers=headers, params=params)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")
    print(response.text)

درخواست‌هایی که بدون کلید API معتبر ارسال شوند، با خطای 401 Unauthorized مواجه خواهند شد.