مستندات المطورين (API)

دليل التكامل لشركات التوصيل والخدمات اللوجستية للوصول إلى عناوين دليل بدقة وسرعة عالية.

المصادقة (Authentication)

جميع طلبات الـ API تتطلب مصادقة باستخدام مفتاح API صالح. يجب تضمين المفتاح في ترويسة الطلب.

Authorization: Bearer <YOUR_API_KEY>

أو باستخدام ترويسة x-api-key.

جلب بيانات العنوان

استخدم هذا المسار لجلب الإحداثيات والبيانات الوصفية للعنوان باستخدام رمز الرابط القصير (Short Code).

GET/v1/public/links/{code}/b2b

مثال للطلب (cURL)

curl -X GET "https://api.dallel.app/v1/public/links/DXB-981/b2b" \
  -H "Authorization: Bearer dallel_b2b_live_ninja_abc123..."

الاستجابة الناجحة (200 OK)

{
  "originalUrl": "https://maps.google.com/?q=24.7136,46.6753",
  "coordinates": {
    "lat": 24.7136,
    "lng": 46.6753
  },
  "metadata": {
    "city": "Riyadh",
    "district": "Al Olaya"
  }
}

أكواد الخطأ الشائعة

401مفتاح API غير صالح أو مفقود

404العنوان غير موجود أو انتهت صلاحيته

429تم تجاوز الحد المسموح من الطلبات

500خطأ داخلي في الخادم