API
عمومی، بدون کلید، با CORS باز. بهعنوان بکاند ویترین مسیریابیها درون برنامه طراحی شده است.
نقطههای پایانی
GET | /api/v1/routings | کاتالوگ. پارامترها: sort، category، q، limit، offset. |
GET | /api/v1/routings/:slug | کارت کامل: قواعد، DNS، خطرها، نسخهها، پیوندهای نصب. |
GET | /api/v1/categories | دستهها همراه با شمارش. |
GET | /api/v1/authors/:handle | نویسنده و مسیریابیهای او. |
GET | /r/:slug.json | نشانی دائمی پروفایل. ETag + 304. |
POST | /api/install/:slug | شمارش نصب (حذف تکرار ۲۴ ساعته). |
نصب
پروفایل برای هر دو کلاینت یکسان است — تنها شیوهٔ تحویل فرق میکند.
| کلاینت | پیوند | بهروزرسانی خودکار |
|---|---|---|
| INCY | incy://autorouting/onadd/<url> | بله |
| Happ | happ://routing/onadd/<base64> | خیر |
Happ فقط base64 میپذیرد و اشتراک از راه URL ندارد، پس یک snapshot دریافت میکند. وارد کردن دوباره پروفایل را در جای خود بهروز میکند: Happ پروفایلی را که Name آن یکسان است بازنویسی میکند.
محدودیتها
بدون کلید، API بهصورت ناشناس و با محدودیت ۳۰۰ درخواست در شبانهروز پاسخ میدهد. با کلید، محدودیت برابر طرح مالک است: ۱٬۰۰۰ روی Free و ۱۰۰٬۰۰۰ روی Pro. کلید در پیشخوان، بخش «امنیت» ساخته میشود.
curl -H "Authorization: Bearer ar_…" https://allrouting.cc/api/v1/routings
در صورت عبور از حد، 429 همراه با سرایند Retry-After برگردانده میشود.
نمونه
curl https://allrouting.cc/api/v1/routings?sort=popular&limit=5