← بازگشت به صفحه اصلی

مستند فنی استفاده از Public API

API Base URL: https://panel.narvan.me

۱. احراز هویت (Authentication)

هر شخص با استفاده از توکنی که در پنل ایجاد کرده می‌تواند پیام ارسال کند.

برای دریافت توکن باید به پنل و منوی کانال مراجعه کنید.

توکن در هدر درخواست Authorization قرار می‌گیرد:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWlFSRUJKNE1HOEQwRFJFNVBZMVcyMyIsImNoYW5uZWxJZCI6IjAxSzhSMzNHMk5QRzdFMTRQV0ZaNzZTVFowIiwiaWF0IjoxNzY5MTU5NTY1fQ.0dmQgQiM0RAaU6d_8M2xe0g6BfuFDN1z2Ygi1Er7BQA

۲. فلو کلی استفاده از API

  1. دریافت توکن در پنل
  2. ایجاد Post Group و دریافت groupId
  3. ارسال پیام پارامتریک برای کاربران
  4. بررسی وضعیت ارسال (اختیاری)

۳. نمونه کد (PHP و Python)

در ادامه نمونه‌ای از ارسال درخواست با هدر احراز هویت در PHP و Python آمده است.

PHP

<?php
$token = 'YOUR_BEARER_TOKEN';
$baseUrl = 'https://panel.narvan.me';

$ch = curl_init($baseUrl . '/api/your-endpoint');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $token,
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

Python

import requests

token = "YOUR_BEARER_TOKEN"
base_url = "https://panel.narvan.me"

headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json",
}

response = requests.get(
    f"{base_url}/api/your-endpoint",
    headers=headers,
)
data = response.json()
بعدی: ایجاد گروه پیام →