سیبمو | آموزش API

• آموزش استفاده از API سیبمو

کلید API

برای استفاده از API سیبمو، ابتدا باید کلید API خود را از پنل کاربری دریافت کنید.

مهم: کلید API خود را در معرض عموم قرار ندهید و آن را محرمانه نگه دارید.

URL پایه

https://sibmo.ir/api/

احراز هویت

برای احراز هویت می‌توانید از یکی از روش‌های زیر استفاده کنید:

                    Header: X-API-Key: YOUR_API_KEY

                    یا

                    GET Parameter: ?api_key=YOUR_API_KEY

endpoints موجود

GET

اطلاعات کاربری

GET /api/?endpoint=user_info

توضیح: دریافت اطلاعات پایه کاربر شامل لینک پرداخت و مقادیر کل

پاسخ نمونه:
{
  "status": "success",
  "data": {
    "paypage": "your-payment-url",
    "donates": 150000,
    "donates_count": 45
  }
}

GET

اطلاعات هدف

GET /api/?endpoint=goal_info

توضیح: دریافت اطلاعات هدف مالی کاربر

پاسخ نمونه:
{
  "status": "success",
  "data": {
    "goal_name": "خرید تجهیزات جدید",
    "filled_amount": 75000,
    "goal_amount": 100000,
    "percentage": 75.00
  }
}

GET

آخرین حمایت‌ها

GET /api/?endpoint=recent_donations

توضیح: دریافت 50 حمایت اخیر

پاسخ نمونه:
{
  "status": "success",
  "data": [
    {
      "name": "علی احمدی",
      "amount": "5000",
      "description": "عالی بود",
      "year": "2025",
      "month": "08",
      "day": "16",
      "unixtime": "1755310220"
    }
  ]
}

GET

بالاترین حمایت‌ها

GET /api/?endpoint=top_donations

توضیح: دریافت 10 حمایت با بالاترین مبلغ

GET

برترین حامیان

GET /api/?endpoint=top_donators

توضیح: دریافت 10 حامی برتر بر اساس مجموع حمایت‌ها

نمونه کد

JavaScript

                    fetch('https://sibmo.ir/api/?endpoint=recent_donations', {

                      headers: {

                        'X-API-Key': 'YOUR_API_KEY'

                      }

                    })

                    .then(response => response.json())

                    .then(data => console.log(data));

PHP

                    $ch = curl_init();

                    curl_setopt($ch, CURLOPT_URL, 'https://sibmo.ir/api/?endpoint=user_info');

                    curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_API_KEY']);

                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

                    $response = curl_exec($ch);

                    $data = json_decode($response, true);

Python

                    import requests

                    headers = {'X-API-Key': 'YOUR_API_KEY'}

                    response = requests.get('https://sibmo.ir/api/?endpoint=goal_info', headers=headers)

                    data = response.json()

کدهای خطا

401 Unauthorized: کلید API نامعتبر یا موجود نیست
400 Bad Request: endpoint نامعتبر
200 OK: درخواست موفق

نکته مهم: تمام پاسخ‌های API در قالب JSON ارسال می‌شوند و دارای فیلد status هستند که وضعیت درخواست را نشان می‌دهد.