API نمایندگان

شروع سریع

1. کلید بگیریددر پنل بخش «API» را باز کنید و کلید بسازید. می‌توانید آن را به آی‌پی سرورتان محدود کنید.
2. ما را به‌عنوان سرویس‌دهنده اضافه کنیددر اسکریپت پنل‌تان، نشانی API را همان نشانی بالا بگذارید و کلید را وارد کنید.
3. سرویس‌ها را وارد کنیدservices را صدا بزنید، سرویس‌هایی را که می‌خواهید بفروشید انتخاب کنید و قیمت خودتان را بگذارید.

قالب درخواست

همهٔ درخواست‌ها POST به یک نشانی هستند. پارامترها را به شکل فرم (application/x-www-form-urlencoded) یا بدنهٔ JSON بفرستید؛ پاسخ همیشه JSON با UTF-8 است.

همهٔ سرویس‌های فعال با قیمت مخصوص شما. فهرست را چند دقیقه ذخیره (کش) کنید و قبل از هر سفارش دوباره نگیرید.

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=services

[
  {
    "service": 1204,
    "name": "Instagram followers — Iranian, high quality, 30-day refill",
    "type": "Default",
    "category": "Instagram — Followers",
    "rate": "48000",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false,
    "dripfeed": false
  }
]

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=1204 \
  -d link=https://instagram.com/yourpage \
  -d quantity=1000

{"order": 10482}

مبلغ هنگام ثبت سفارش از کیف پول کم می‌شود و هر بخشی که تحویل نشود خودکار برمی‌گردد.

حداکثر ۱۰۰ شمارهٔ سفارش، جداشده با ویرگول.

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=10482,10483

{
  "10482": {"charge": "48000", "start_count": "1520", "status": "Completed", "remains": "0", "currency": "IRT"},
  "10483": {"error": "Incorrect order ID"}
}

برای سرویس‌های دارای refill: true، هر سفارش یک بار در ۲۴ ساعت. برای چند سفارش، orders را با ویرگول بفرستید.

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=10482

{"refill": 50017}

فقط برای سرویس‌های دارای cancel: true و پیش از شروع تحویل. بخش تحویل‌نشده خودکار بازگردانده می‌شود.

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=10482,10483

[
  {"order": 10482, "cancel": 1},
  {"order": 10483, "cancel": {"error": "Cancel is not available for this order"}}
]

وضعیت‌های سفارش

خطاها

خطاها به شکل {"error": "…"} برمی‌گردند. متن خطاها ثابت است و کد شما می‌تواند آن را بررسی کند.

HTTP 429 یعنی درخواست‌ها زیاد است؛ یک دقیقه صبر کنید و سرعت را کم کنید.

نمونه کد

<?php
function api(array $params): array
{
    $ch = curl_init('https://clickpop.ir/api/reseller/v1');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query(['key' => 'YOUR_KEY'] + $params),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
    ]);
    $json = json_decode((string) curl_exec($ch), true);
    curl_close($ch);
    return is_array($json) ? $json : ['error' => 'No response'];
}

$order = api(['action' => 'add', 'service' => 1204, 'link' => 'https://instagram.com/yourpage', 'quantity' => 1000]);
print_r($order);

import requests

def api(**params):
    r = requests.post("https://clickpop.ir/api/reseller/v1", data={"key": "YOUR_KEY", **params}, timeout=30)
    return r.json()

print(api(action="balance"))
print(api(action="add", service=1204, link="https://instagram.com/yourpage", quantity=1000))

const api = async (params) => {
  const res = await fetch("https://clickpop.ir/api/reseller/v1", {
    method: "POST",
    body: new URLSearchParams({ key: "YOUR_KEY", ...params }),
  });
  return res.json();
};

console.log(await api({ action: "balance" }));
console.log(await api({ action: "status", orders: "10482,10483" }));

محدودیت و امنیت

• تا ۲۴۰ درخواست در دقیقه برای هر کلید.
• هر کلید را می‌توانید به IP سرورهای خودتان محدود کنید.
• کلیدها فقط یک‌بار نمایش داده می‌شوند و به‌صورت هش ذخیره می‌شوند؛ هر زمان خواستید باطل کنید و کلید تازه بسازید.
• کلید را فقط روی سرور نگه دارید؛ هرگز در کد جاوااسکریپت سایت یا اپلیکیشن موبایل قرار ندهید.