واجهة المطورين
واجهة REST JSON. استعلام واحد لكل طلب بغض النظر عن حجم الصفحة. التصنيفات و/me مجانية.
المصادقة
أنشئ مفتاحاً من لوحة التحكم ثم أرسل:
Authorization: Bearer la_live_…
عنوان الأساس
https://leadatlas.161.97.155.24.nip.io/api/v1
GET /api/v1/me
الخطة والحصص وحدود الصفحات (مجاناً).
curl -H "Authorization: Bearer $KEY" https://leadatlas.161.97.155.24.nip.io/api/v1/me
GET /api/v1/search
معاملات الاستعلام كما في الواجهة.
curl -G "https://leadatlas.161.97.155.24.nip.io/api/v1/search" \
-H "Authorization: Bearer $KEY" \
--data-urlencode "q=dental" \
--data-urlencode "country=saudi" \
--data-urlencode "has_phone=1" \
--data-urlencode "per_page=10"
GET /api/v1/places/{id}
منشأة واحدة (استعلام واحد).
GET /api/v1/facets
الدول والمدن والقطاعات (مجاناً).
حدود الصفحات
قيمة per_page محدودة بخطتك، والصفحات التي تتجاوز حد خطتك تُعيد 402 مع إجمالي عدد النتائج لتعرف ما تفتحه الترقية.
{
"error": "page_locked",
"total": 552,
"visible": 20,
"max_pages": 1,
"per_page": 20
}
ترويسات الاستجابة
X-PlanX-Queries-RemainingX-Queries-LimitX-Max-PagesX-RateLimit-Limit
الأخطاء
401— مفتاح مفقود أو غير صالح402— استنفدت استعلامات الشهر، أو الصفحة محجوبة في خطتك429— تجاوز معدل الطلبات لخطتك