OAuth 2.0 · MCP
المطوّرون

اربط أي نظام بـOneBooks.

واجهة OAuth 2.0 قياسية برموز محددة الصلاحيات وwebhooks، إضافة إلى MCP لوكلاء الذكاء الاصطناعي — أساس منصة مطوّري OneBooks. زامِن نظامك أو ابنِ وكيلًا هنا، ثم تقدّم أكثر بتطبيقات تعمل داخل OneBooks وإدراج في المتجر.

شاهد ما يراه التجار

OAuth 2.0 + PKCE

رمز التفويض، وتدوير التحديث، والتسجيل الديناميكي، وتدفق الأجهزة

رموز محددة الصلاحيات

صلاحيات قراءة وكتابة لكل مجال — الفواتير والدفعات والتقارير…

كل الخطط

الوصول إلى الواجهة البرمجية وMCP في كل خطط OneBooks، بما فيها المجانية

كيف يعمل

من اللوحة إلى العملاء.

01

سجّل تطبيقك

أنشئه في لوحة المطوّرين وابنِ على منشآت تجريبية مجانية.

02

ابنِ

OAuth 2.0 قياسي مع PKCE والصلاحيات؛ ونقاط اتصال موثّقة للمستندات والدفعات والتقارير؛ وwebhooks لكل ما يتغيّر؛ وMCP إن كنت تبني وكيلًا.

03

انطلق

اجتز مراجعة التطبيق فيصبح بإمكان تطبيقك الاتصال بأي منشأة على OneBooks. ولتظهر في المتجر، قدّم إدراجًا يخضع لمراجعته الخاصة.

الواجهة البرمجية

معايير، لا مفاجآت.

إن كنت قد تكاملت مع أي مزوّد OAuth حديث، فأنت تعرف أصلًا كيف يعمل هذا.

  • ✓ OAuth 2.0 — رمز تفويض مع PKCE، وتدوير رموز التحديث، وتسجيل ديناميكي RFC 7591، وتدفق أجهزة RFC 8628 للتطبيقات الأصلية، واكتشاف RFC 8414 / 9728.
  • ✓ صلاحيات لكل مجال — الفواتير والدفعات والمشتريات والتقارير وغيرها، قراءة أو كتابة، بموافقة لكل منشأة.
  • ✓ أمان عند التكرار في كل مكان — كل كتابة مالية تقبل مفتاح منع التكرار (idempotency key)، فإعادة المحاولة آمنة.
  • ✓ Webhooks وواجهة للأحداث — تسليم موقَّع مع إعادة المحاولة لأكثر من 40 نوعًا من الأحداث، وسجل أحداث تستدرك منه ما فاتك.
  • ✓ إصدارات مؤرّخة للواجهة — ثبّت الإصدار الذي بنيت عليه؛ ويبقى كل إصدار مدعومًا 12 شهرًا بعد صدور الإصدار التالي.
  • ✓ MCP للوكلاء — يعرض سطح التفويض نفسه أدوات محددة الأنواع لوكلاء الذكاء الاصطناعي، بكتابات يؤكدها إنسان.
منصة التطبيقات

أبعد من الواجهة البرمجية.

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

  • ✓ تطبيقات داخل OneBooks — صفحاتك الخاصة، وإجراءات في قائمة «التطبيقات» على السجل، وبطاقات على السجلات واللوحة الرئيسية، داخل إطار معزول برموز جلسة قصيرة الأجل.
  • ✓ بيانات التطبيق على السجلات — حقولك الخاصة بأنواع بيانات محددة على الفواتير والعملاء والأصناف وتسعة أنواع أخرى من السجلات.
  • ✓ الوظائف المُستضافة — يعمل كودك عند وقوع الأحداث داخل بيئة معزولة لا تصل إلا إلى الوجهات التي تعلنها.
  • ✓ متجر التطبيقات — اجتز مراجعة الإدراج فتتمكّن كل منشأة على OneBooks من العثور على تطبيقك وتثبيته؛ وتفوتر عملاءك مباشرة وتحتفظ بـ100% مما تتقاضاه.
  • ✓ منشآت تجريبية — ابنِ واختبر دون لمس دفاتر حقيقية.

واجهة OneBooks البرمجية — أسئلة شائعة

ما المصادقة التي تستخدمها الواجهة؟

OAuth 2.0 — رمز تفويض مع PKCE للتطبيقات، وتسجيل عملاء ديناميكي للعملاء ذاتيي الخدمة، وتدفق الأجهزة للتطبيقات الأصلية بلا إعادة توجيه، وتدوير رموز التحديث في كل ذلك.

هل توجد بيئة تجريبية؟

نعم — توفّر لوحة المطوّرين منشآت تجريبية لتبني وتختبر على دفاتر واقعية دون لمس بيانات أي عميل.

أي خطط OneBooks تستطيع ربط تطبيقي؟

كلها. الوصول إلى الواجهة البرمجية وMCP مشمول في كل خطة، بما فيها المجانية، فتستطيع أي منشأة على OneBooks ربط تطبيقك.

هل أحتاج إلى إدراج في المتجر؟

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

هل أستطيع بناء وكيل ذكاء اصطناعي عليها؟

نعم — يعرض OneBooks خادم MCP على سطح OAuth نفسه، بأدوات محددة الأنواع ووصول محدد الصلاحيات وكتابات يؤكدها إنسان.

هل يمكن أن يحصل عملائي على OneBooks دون مقابل؟

عبر برنامج الشركاء، يستطيع مزوّدو أنظمة نقاط البيع والمنصات منح عملائهم الذين يُتحقَّق منهم خطة Standard من OneBooks دون مقابل. أخبرنا عن منتجك في صفحة «كن شريكًا لنا».

أيضًا في هذه الفئة: منصة المطوّرين التكاملات
ابنِ على OneBooks

ابنِ التكامل الذي يطلبه عملاؤك.

أنشئ حساب مطوّر مجانيًا، وابنِ على بيئة تجريبية، وانطلق بعد مراجعة واحدة.