مستندات API

۱) آدرس پایه و احراز هویت

تمام درخواست‌ها با هدر X-API-Key یا Authorization: Bearer TOKEN احراز هویت می‌شوند. کلید را از بخش «کلیدهای API» بسازید.

۲) فهرست سرویس‌ها

برای دیدن قیمت لحظه‌ای سرویس‌ها به ریال:

GET /api/v1/services
X-API-Key: ak_xxxxxxxx

۳) ثبت سفارش (استعلام)

POST /api/v1/orders
X-API-Key: ak_xxxxxxxx
Content-Type: application/json

{
  "service": "imei-find-my-iphone-1",
  "input": "359111099999999",
  "wait": true
}

• service — شناسه یکتای سرویس (slug) یا service_id (عدد).
• input — شماره IMEI یا سریال دستگاه.
• wait — اگر true باشد نتیجه همان لحظه برگردانده می‌شود؛ در غیر این صورت سفارش در صف قرار می‌گیرد و با GET /api/v1/orders/{id} پیگیری می‌شود.

پاسخ

{
  "success": true,
  "data": {
    "id": 12,
    "status": "success",
    "service_title": "Find My iPhone [ FMI ] (ON/OFF)",
    "input": "359111099999999",
    "price_usd": 0.01,
    "price_rial": 12000,
    "upstream_order": "74275656",
    "result": "iPhone 15 Pro (A3104)\nIMEI: 35698831919XXX\nFind My iPhone: ON",
    "object": { "model": "iPhone 15 Pro (A3104)", "fmiOn": true },
    "error": null,
    "duration_ms": 1950,
    "created_at": "2026-10-20 12:00:00"
  }
}

import requests

BASE = "https://center.shirazid.com"
KEY  = "ak_xxxxxxxx"

headers = {"X-API-Key": KEY}

# ۱) موجودی کیف پول
balance = requests.get(BASE + "/api/v1/balance", headers=headers).json()
print(balance["data"]["balance"])   # ریال

# ۲) ثبت سفارش
res = requests.post(
    BASE + "/api/v1/orders",
    headers=headers,
    json={"service": "imei-find-my-iphone-1",
          "input": "359111099999999",
          "wait": True},
)
data = res.json()["data"]
print(data["status"])   # success / failed / pending
print(data["result"])

class ApiCenter:
    def __init__(self, base_url, api_key):
        self.base = base_url.rstrip("/")
        self.headers = {"X-API-Key": api_key}

    def balance(self):
        r = requests.get(self.base + "/api/v1/balance", headers=self.headers)
        return r.json()["data"]["balance"]

    def imei_check(self, service, imei):
        r = requests.post(
            self.base + "/api/v1/orders",
            headers=self.headers,
            json={"service": service, "input": imei, "wait": True},
            timeout=40,
        )
        if r.status_code != 200:
            raise RuntimeError(r.text)
        return r.json()["data"]

۴) PHP (cURL)

function apiRequest(string $path, array $body = []): array
{
    global $apiKey;

    $ch = curl_init(API_BASE_URL . $path);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            "X-API-Key: {$apiKey}",
            "Content-Type: application/json",
        ],
        CURLOPT_POSTFIELDS => json_encode($body),
        CURLOPT_TIMEOUT => 40,
    ]);

    $raw = curl_exec($ch);
    curl_close($ch);

    return json_decode((string)$raw, true);
}

$order = apiRequest("/api/v1/orders", [
    "service" => "imei-find-my-iphone-1",
    "input"   => $imei,
    "wait"    => true,
]);

echo $order["data"]["result"];

۵) سایر نقاط پایانی