البدء

نظرة عامة

توفر Oolel Maps واجهة REST للترميز الجغرافي والبحث والملاحة عبر غرب إفريقيا. جميع النقاط تحت البادئة /api/v1، تُرجع JSON وتدعم الفرنسية والعربية والإنجليزية عبر معامل اللغة.

https://api.oolelmaps.com/api/v1

توجه إلى صفحة التسجيل وأنشئ حساب مطور مجاني. ستحتاج إلى عنوان بريدك الإلكتروني وكلمة مرور، واختياريًا اسم شركتك.

بعد تسجيل الدخول، انتقل إلى قسم مفاتيح API في لوحة التحكم. انقر على «إنشاء مفتاح جديد» وامنحه اسمًا وصفيًا (مثال: «إنتاج» أو «تطوير»). انسخ مفتاحك وخزّنه بأمان — لن يُعرض مرة أخرى بعد الإنشاء.

استخدم مفتاح API في الترويسة Authorization مع البادئة Bearer. فيما يلي طلب ترميز جغرافي أمامي بسيط:

curl -X GET "https://api.oolelmaps.com/api/v1/geocode/forward?address=Tevragh+Zeina+Nouakchott" \
  -H "Authorization: Bearer YOUR_API_KEY"

المصادقة

يجب أن تتضمن كل طلبات API مفتاحك في الترويسة Authorization:

Authorization: Bearer YOUR_API_KEY

تتلقى الطلبات التي لا تحمل مفتاحًا صالحًا استجابة 401 Unauthorized.

حدود المعدل

يُطبَّق throttling عام على كل مفتاح API لمنع إساءة الاستخدام. إذا تجاوزت الحد، ترد الواجهة بـ 429 Too Many Requests. تواصل مع الدعم إذا احتاج عبء الإنتاج لديك طاقة أعلى.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709683200

معالجة الأخطاء

تستخدم الواجهة رموز HTTP القياسية. تتضمن استجابات الخطأ جسم JSON مع رسالة وصفية:

{
  "statusCode": 400,
  "message": "Query parameter 'address' is required",
  "error": "Bad Request"
}