تخطَّ إلى المحتوى

المطوّرون

ابنِ على Route Royal

SDK وواجهة API وخطافات الويب وتطبيقات OAuth وخادم MCP، لمواقعك وتطبيقاتك ووكلائك الخاصين. أدوات المطوّرين في البوابة، ومتاحة للمؤسسات التي منحناها وصول المطوّرين.

  1. مطوّر لديه وصول

  2. مسجَّل الدخولحساب Route Royal الخاص بك
  3. مؤسستكالوصول يخصها
  4. دوركيُسمح له بإدارة إعدادات المطوّرين
  5. وصول المطوّرينممنوح لمؤسستك
  6. بوابة المطوّرينمصرَّح

اجتاز كل الفحوصات: المفاتيح والتطبيقات وخطافات الويب بين يديك لتديرها.

ما تبني به

خمسة مداخل

يعمل كلٌّ منها ضمن بيانات مؤسستك والصلاحيات التي تمنحها.

  • SDK لـ Next.js

    Hooks مُنمَّطة للمتصفح وعملاء للخادم: المصادقة والإعلانات والحجوزات والاستفسارات والمنشورات والتجارة والتحليلات للمواقع Headless. وهذا الموقع نفسه يعمل عليه.

  • واجهة REST API

    اقرأ بيانات مؤسستك واكتبها عبر api.routeroyal.com، بمفاتيح محصورة فيما يحتاجه كل تكامل.

  • خطافات الويب

    أحداث لجهات الاتصال والصفقات والعقارات والمنتجات والطلبات والمدفوعات وغيرها، موقَّعة بـ HMAC-SHA256 لتتحقق من أنها صادرة منا.

  • تطبيقات OAuth

    دع الناس يسجّلون الدخول عبر Route Royal وتصرّف نيابةً عنهم عبر OAuth 2.0: رموز التفويض والرموز المميزة والإلغاء.

  • خادم MCP

    امنح وكلاءك الخاصين أدوات Route Royal عبر Model Context Protocol، ضمن الصلاحيات التي تمنحها.

الحصول على الوصول

من الطلب إلى المفاتيح الفعلية

  1. 1

    اطلب الوصول

    أخبرنا بما تبنيه ولأي مؤسسة.

  2. 2

    نفعّله لك

    نفعّل وصول المطوّرين لمؤسستك وفق شروط نتفق عليها معك.

  3. 3

    أنشئ مفاتيحك

    سجّل الدخول، وسجّل نطاقك، وتحقق منه عبر DNS، ثم أنشئ مفتاحًا عامًا ومفتاحًا سريًّا.

  4. 4

    انطلق

    ابنِ بمفاتيح الاختبار، ثم انتقل إلى المفاتيح الفعلية عند الإطلاق.

المفاتيح

مفتاحان، كلٌّ على حدة

كل مفتاح SDK يعود إلى نطاق تحققتَ منه. يظهر المفتاح كاملًا مرة واحدة فقط، ولا نحتفظ إلا بقيمة hash الخاصة به.

  • المفاتيح العامة (pk_) للقراءة فقط، فهي آمنة في المتصفح.
  • المفاتيح السرية (sk_) تستطيع الكتابة، فتبقى على خادمك.
  • كل مفتاح مرتبط بنطاق تم التحقق منه، ويمكن أن يحمل تاريخ انتهاء وقائمة IP مسموحة.
  • الطلبات محدودة المعدل، فلا يزاحم أي تكامل غيره.
.env.local
NEXT_PUBLIC_ROUTEROYAL_DOMAIN=www.example.com
NEXT_PUBLIC_ROUTEROYAL_PUBLIC_KEY=pk_test_…

# على الخادم فقط: لا يوضع أبدًا في كود المتصفح
ROUTEROYAL_SECRET_KEY=sk_test_…

أسئلة

ما يسأل عنه المطوّرون

من يستطيع الحصول على وصول المطوّرين؟

المؤسسات على Route Royal. نمنحه لكل مؤسسة، ويستخدمه داخلها من يتيح له دوره إدارة إعدادات المطوّرين.

هل يكلّف وصول المطوّرين مبلغًا إضافيًا؟

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

أين التوثيق؟

يأتي مع الوصول. الـ SDK حزمة خاصة يرافقها دليلها، ونرافق كل تكامل جديد مع الفريق الذي يبنيه.

هل أحتاج وصول المطوّرين لاستخدام Claude أو ChatGPT مع Route Royal؟

لا. ربط Claude أو ChatGPT بمؤسستك جزء من الذكاء الاصطناعي وQ. أما وصول المطوّرين فلبناء مواقعك وتطبيقاتك ووكلائك الخاصين.

هل توجد حدود للمعدل؟

نعم. لكل مفتاح ورمز حد للمعدل، ولوكلاء الذكاء الاصطناعي حدودهم الخاصة في الدقيقة وفي الجلسة. نخبرك بالحدود المنطبقة عند منح الوصول.

هل بُني عليه شيء اليوم؟

هذا الموقع. أخباره منشورات Route Royal تُقرأ عبر SDK، بالطريقة نفسها التي سيقرأ بها موقعك إعلاناتك أو حجوزاتك أو منشوراتك.

وصول المطوّرين

أجرِ أول استدعاء لك إلى Route Royal

يُمنح وصول المطوّرين لكل مؤسسة على حدة. أخبرنا بما تبنيه ولأي مؤسسة. وبمجرد تفعيله، تُنشئ مفاتيحك في البوابة وتُجري هذا الاستدعاء بمفاتيحك.

تُرسل الطلبات بالبريد الإلكتروني إلى support@routeroyal.com.

lib/news.ts
المخرجات

منشوران، قُرئا على خادمك بمفتاح عام: هكذا يقرأ هذا الموقع أخباره.

مفاتيح وبيانات للتوضيح