معرفی

این سند راهنمای کاملی برای استفاده از APIهای NestCode فراهم می‌کند. اگر توسعه‌دهنده هستید و قصد دارید سرویس‌های ما را در برنامه خود استفاده کنید، این صفحه نقطه شروع شماست.

آدرس پایه​

https://open.nestcode.org/{api_version}/{api_name}

احراز هویت​

برای استفاده از API، باید توکن خود را از طریق پارامتر key به صورت GET ارسال کنید:

https://open.nestcode.org/{api_version}/{api_name}?key={license}

نمونه درخواست​

[https://open.nestcode.org/v1/sample?key={license}](https://open.nestcode.org/v1/sample?key={license})

نمونه کد​

<?php

$params = http_build_query([
    'key' => 'License',
    'q' => 'hello world'
]);

$ch = curl_init("https://open.nestcode.org/v1/ChatGP?" . $params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

import requests

url = "[https://open.nestcode.org/v1/ChatGP](https://open.nestcode.org/v1/ChatGP)"
params = {
"key": "License",
"q": "hello world"
}

response = requests.get(url, params=params)
print(response.json())

curl "https://open.nestcode.org/v1/sample?key=license"

فرمت پاسخ​

{
  "detail": {
    "status": "success", // success, fail
    "developer": "t.me/N3x74",
    "data": {
      // array, string
    }
  }
}

توضیحات کلیدها:​

• detail: بدنه کلی درخواست در آن قرار دارد
• status: وضعیت درخواست (success, fail)
• developer: اطلاعات اضافی شامل توسعه دهندگان
• data: محتوای پاسخ، که می‌تواند رشته، آرایه یا آبجکت باشد

کدهای خطا​

نکات امنیتی و فنی​

• از پروتکل HTTPS استفاده کنید.
• توکن دسترسی را هرگز در سمت کلاینت نمایش ندهید.
• به نرخ درخواست مجاز (Rate Limiting) توجه داشته باشید.
• همواره پاسخ‌ها و خطاها را به درستی مدیریت کنید.

define('API_BASE_URL', 'https://open.nestcode.org/v1/');
define('API_KEY', 'your_token_here');

API_BASE_URL = "https://open.nestcode.org/v1/"
API_KEY = "your_token_here"

منابع تکمیلی​

• مقدمه مستندات
• دریافت توکن از طریق بات تلگرام
• سوالات متداول