مستندات API

معرفی

با یک درخواست ساده‌ی POST می‌توانید هر آدرسی را کوتاه کنید. این API عمومی و رایگان است. برای استفاده‌ی معمولی نیازی به کلید نیست؛ اما با گرفتن یک کلید رایگان از پنل، سقف درخواست شما بالاتر می‌رود.

نقطه پایانی (Endpoint)

POST https://cinp.ir/api_auto_link.phpContent-Type: application/json

بدنه‌ی درخواست

{
  "long_url": "https://example.com/survey.php?t=XXXXXXXX"
}

فیلدهای اختیاری:

• api_key — کلید API برای سقف بالاتر (اختیاری).
• custom_code — کد دلخواه به‌جای کد تصادفی (اختیاری).

پاسخ موفق

{
  "status": 1,
  "short_url": "https://cinp.ir/AbC123",
  "code": "AbC123"
}

پاسخ خطا

{
  "status": 0,
  "message": "شرح خطا"
}

محدودیت نرخ (Rate Limit)

• بدون کلید: 5 درخواست در روز برای هر IP.
• با کلید معتبر: تا 500 درخواست در روز.

در صورت عبور از سقف، کد وضعیت 429 و هدر Retry-After برگردانده می‌شود.

نمونه‌ها

cURL

curl -X POST https://cinp.ir/api_auto_link.php \
  -H "Content-Type: application/json" \
  -d '{"long_url":"https://example.com/very/long/path"}'

JavaScript (fetch)

const res = await fetch("https://cinp.ir/api_auto_link.php", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ long_url: "https://example.com/very/long/path" })
});
const data = await res.json();
if (data.status === 1) console.log(data.short_url);

PHP

$ch = curl_init("https://cinp.ir/api_auto_link.php");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS     => json_encode(["long_url" => "https://example.com/x"]),
]);
$data = json_decode(curl_exec($ch), true);
echo $data["short_url"] ?? $data["message"];

Python

import requests
r = requests.post("https://cinp.ir/api_auto_link.php",
                  json={"long_url": "https://example.com/very/long/path"})
d = r.json()
print(d["short_url"] if d["status"] == 1 else d["message"])

با کلید API

curl -X POST https://cinp.ir/api_auto_link.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"long_url":"https://example.com/x"}'