بوابة المطوّرين
بوابة المطوّرين
بوابة المطوّرين على navvo.io/developer هي أسرع طريقة للعمل مع واجهة Navvo البرمجية. إنها وحدة تحكّم بالنقر لكل ما قد تفعله عبر REST — المؤسسات والمشاريع ومفاتيح API والاستخدام الحيّ وبيئة اختبار للطلبات.
كل ما في البوابة مرتبط بحسابك: فأنت لا ترى وتدير إلا المؤسسات والمشاريع والمفاتيح التي أنشأتها.
developer (أو admin / super_admin). الحساب المُسجَّل حديثًا يملك دور user فقط — تواصل مع Navvo لمنح دور المطوّر. راجع المصادقة لنموذج الأدوار.التنظيم
تنقسم البوابة إلى أربع علامات تبويب:
نظرة عامة
أعداد مؤسساتك ومشاريعك ومفاتيحك، وإجمالي طلبات اليوم، وإعداد موجَّه من ثلاث خطوات. ::::
مساحة العمل
إنشاء المؤسسات والمشاريع داخلها وإعادة تسميتها وحذفها. ::::
مفاتيح API
إصدار المفاتيح، وتعديل النطاقات/الخطة/الحصص، وتدوير الأسرار، والتفعيل/التعطيل، والحذف — مع استخدام حيّ لكل مفتاح. ::::
بيئة الاختبار
1. إعداد مساحة عمل
افتح علامة تبويب مساحة العمل وأنشئ مؤسسة (يُولَّد لها مُعرِّف URL تلقائيًا). داخل بطاقة كل مؤسسة، أضف مشروعًا أو أكثر — عادةً واحدًا لكل تطبيق أو بيئة (مثلاً تطبيق السائق وتطبيق الراكب، أو تجريبي وإنتاج).
2. إصدار مفتاح API
انتقل إلى علامة تبويب مفاتيح API واملأ نموذج إنشاء مفتاح API:
اختر مشروعًا
اختر من قائمة منسدلة بمشاريعك (مجمّعة كـ مؤسسة / مشروع) — دون نسخ أي معرّفات.
سمِّ المفتاح
امنحه تسمية واضحة مثل Driver App — production.
اختر خطة
free أو startup أو growth أو enterprise. تحدّد الخطة الحصص الافتراضية؛ ويمكنك ضبطها لاحقًا.
(اختياري) عدّل النطاقات
وسّع النطاقات لتفعيل ما يستطيع المفتاح فعله بالضبط. ثمانية نطاقات مفعّلة افتراضيًا؛ وgeo وinsights وoptimize اشتراك اختياري. راجع المصادقة ← النطاقات.
عند النقر على إصدار مفتاح API، يُعرَض السرّ الكامل مرّة واحدة في لافتة مميّزة. انسخه فورًا — إذ تُخزِّن Navvo تجزئة فقط، فلا يمكن عرضه مجدّدًا أبدًا.
3. إدارة مفاتيحك
يُظهر كل مفتاح في مفاتيح API الخاصة بك تسميته، والأحرف الأربعة الأخيرة، والخطة، والحالة، وعدد النطاقات، ووقت آخر استخدام، ومقياسَي استخدام حيّين (الطلبات في هذه الدقيقة واليوم، مقابل حصّة المفتاح — يتحدّثان تلقائيًا).
إجراءات كل مفتاح هي:
| الإجراء | الأيقونة | ما يفعله |
|---|---|---|
| تفعيل / تعطيل | الطاقة | تبديل المفتاح بين التشغيل والإيقاف. يُرفَض المفتاح غير المفعّل بالرمز 403 حتى إعادة تفعيله. |
| تعديل | القلم | تغيير التسمية والخطة والنطاقات وحصص الدقيقة / اليوم. |
| تدوير | التحديث | توليد سرّ جديد وإبطال القديم فورًا (مع نفس المعرّف والنطاقات والحصص). يُعرَض السرّ الجديد مرّة واحدة. |
| حذف | السلّة | إزالة المفتاح نهائيًا. تتوقّف الطلبات التي تستخدمه فورًا. |
4. التجربة في بيئة الاختبار
تتيح لك علامة تبويب بيئة الاختبار إطلاق طلبات حقيقية إلى واجهة Navvo ومشاهدة الاستجابة الحيّة.
- اختر مفتاح API — وهذا إلزامي. تعرض القائمة مفاتيحك أنت فقط، فلا يغادر السرّ الخادم أبدًا: تُمرِّر البوابة الطلب من جهة الخادم بهويّة المفتاح الذي اخترته.
- اختر نقطة نهاية من القائمة المنسّقة للقراءة فقط (البحث، الترميز الجغرافي، الأماكن، التوجيه، الفحص الصحّي، …). ولنقاط نهاية
POST(حسابية للقراءة فقط، مثل التوجيه) يمكنك تعديل جسم JSON. تكشف بيئة الاختبار عمدًا نقاط النهاية الآمنة غير المُعدِّلة فقط. - أرسل الطلب — يكون الزرّ معطّلاً حتى تختار مفتاحًا.
تعرض لوحة الاستجابة حالة HTTP وزمن الرحلة وجسم JSON المنسّق. تطبّق بيئة الاختبار فحوصات نطاق المفتاح وحالة تفعيله قبل التمرير: إذا كان المفتاح المختار غير مفعّل، أو يفتقد نطاقًا تحتاجه نقطة النهاية، فستحصل على 403 يوضّح الخطأ بالضبط — وسيلة سريعة للتحقّق من صحّة إعداد المفتاح قبل الإطلاق.
x-api-key.تفضّل الواجهة البرمجية؟
كل ما في البوابة مدعوم بنقاط نهاية /developer/* الموثّقة في المصادقة ← إدارة المفاتيح، فيمكنك أتمتة إدارة المؤسسات والمشاريع والمفاتيح في أدواتك الخاصة.