البدء

كل تكامل مع API360 يبدأ بالطريقة نفسها: التسجيل، الحصول على مفتاح، ثم استدعاء بيئة Sandbox. لا قائمة انتظار للموافقة، ولا مكالمة مبيعات — الخطوات أدناه هي كل ما تحتاجه.

1. أنشئ حساباً واحصل على مفتاح API

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

احتفظ بالمفتاح بعيداً عن كود الواجهة الأمامية وعن نظام التحكّم بالإصدارات — عامِله تماماً كما تعامل كلمة مرور.

2. اضبط الـ base URL وترويسة المصادقة

يحمل كل طلب مفتاحك في ترويسة Authorization، وكل طلب على Sandbox يكون على https://sandbox.api360.sa:

export API360_KEY="sk_sandbox_your_key_here"

طلبات الإنتاج تستخدم الترويسة نفسها على https://api.api360.sa بعد ترقية التطبيق خارج Sandbox.

3. نفّذ أول طلب

بعد تصدير المفتاح، استدعِ فحص الجاهزية لخدمة الهويّة:

curl "https://sandbox.api360.sa/v1/identity/ping" \
  -H "Authorization: Bearer $API360_KEY"

المفتاح الصحيح يُعيد 200 OK مع جسم JSON صغير:

{ "status": "ok", "environment": "sandbox" }

من هنا، استعرِض السوق لكامل فهرس الواجهات، أو تابع القراءة — الصفحات التالية تغطّي المصادقة والحصص والاستدعاءات الراجعة بالتفصيل.