ابنِ تطبيقات للشركات التي تعمل على OneBooks
واجهة OAuth وMCP، وصفحات مضمّنة داخل OneBooks مباشرة، وبيانات تطبيقك على سجلات حقيقية، ووظائف مُستضافة — وصِل إلى كل منشأة على OneBooks عبر إدراج واحد مُراجَع في المتجر.
أربع طرق لتوسيع OneBooks
واجهة OAuth وwebhooks
واجهة REST عبر OAuth 2.0 بصلاحيات محددة على الفواتير والمدفوعات والعملاء والتقارير وغيرها، إضافة إلى MCP لوكلاء الذكاء الاصطناعي. تصلك أكثر من 40 نوعًا من الأحداث عبر webhooks أو واجهة الأحداث — مع كتابات آمنة عند التكرار (idempotent)، وإصدارات مؤرّخة، وتوثيق مرجعي كامل.
تطبيقات داخل OneBooks
صفحاتك الخاصة داخل OneBooks، إضافة إلى إجراءات وبطاقات في 15 موضعًا — اللوحة الرئيسية وسبعة أنواع من السجلات، من الفواتير إلى مرتجعات المشتريات — داخل إطار معزول، بمصادقة عبر رموز جلسة قصيرة الأجل.
بيانات التطبيق على السجلات
احفظ حقولك الخاصة بأنواع بيانات محددة على 12 نوعًا من السجلات — العملاء والفواتير والأصناف وغيرها — ليراها التاجر مباشرة على السجل، حيث يعمل أصلًا.
الوظائف المُستضافة
شغّل كودك عند وقوع الأحداث داخل بيئة معزولة على بنية OneBooks التحتية، لا تصل إلا إلى الوجهات التي تعلنها — ودون خادم تديره للأتمتة البسيطة.
من الصفحة المضمّنة إلى بيانات الدفاتر
يسلّم App Bridge صفحتك المضمّنة رمز جلسة قصير الأجل، ويستبدله خادمك برمز وصول — ثم يصبح الأمر استدعاءً عاديًا للواجهة البرمجية. بلا إعادة توجيه، ودون حاجة إلى حزمة تطوير.
curl -X POST https://api.getonebooks.com/oauth/token \
-u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
-d grant_type=urn:ietf:params:oauth:grant-type:token-exchange \
-d subject_token=SESSION_TOKEN \
-d subject_token_type=urn:ietf:params:oauth:token-type:jwtcurl https://api.getonebooks.com/invoices \
-H "Authorization: Bearer ACCESS_TOKEN"منصة لمطوّرين يُطلقون منتجاتهم
- ✓ كل خطة — بما فيها المجانية — تشمل الوصول إلى الواجهة البرمجية، فيستطيع أي تاجر تثبيت تطبيقك
- ✓ خمس لغات منها العربية، بدعم كامل للكتابة من اليمين إلى اليسار
- ✓ إدراج مُراجَع في المتجر، وانتشار داخل التطبيق الذي يستخدمه كل تاجر بالفعل
- ✓ منشآت تجريبية مجانية للبناء والاختبار، دون أي مخاطرة على دفاتر حقيقية
- ✓ تفوتر عملاءك مباشرة وتحتفظ بـ100% من إيراداتك
- ✓ حدود استخدام لكل تطبيق ولكل منشأة، فلا تستهلك حركةُ التطبيقات الأخرى حصتك أبدًا
- ✓ إصدارات للواجهة البرمجية بتواريخ محددة، مع 12 شهرًا من الدعم بعد كل إصدار جديد
من الفكرة إلى المتجر
- 01
أنشئ حساب مطوّر
سجّل في لوحة المطوّرين — مجانًا، ولا يستغرق سوى دقيقتين.
- 02
ابنِ في بيئة تجريبية
سجّل تطبيقك وابنِ على منشآت تجريبية مجانية، دون أي مخاطرة على دفاتر حقيقية.
- 03
اجتز مراجعة التطبيق
إلى أن يُعتمد تطبيقك، لا يتصل إلا بمنشآتك التجريبية. تتحقق مراجعة التطبيق منه قبل أن تستخدمه منشآت حقيقية.
- 04
اجتز مراجعة الإدراج
قدّم إدراجك في المتجر. بعد أن تعتمده مراجعة الإدراج يُنشر — ويصبح بإمكان كل منشأة على OneBooks العثور على تطبيقك وتثبيته.
أقل الصلاحيات، افتراضيًا
- ✓ تعمل الصفحات المضمّنة داخل إطارات معزولة من أصل مختلف، تُوثَّق برموز جلسة قصيرة الأجل — لا ملف تعريف ارتباط مشترك أبدًا
- ✓ يقتصر كل تثبيت على الصلاحيات التي يطلبها بالضبط، بموافقة التاجر، ولا شيء أكثر
- ✓ تعمل الوظائف المُستضافة داخل عمّال معزولين بقائمة معلنة ومفروضة من الوجهات التي يمكنهم الوصول إليها
- ✓ كل كتابة يجريها تطبيقك تُنسَب إليه في سجل تدقيق التاجر
- ✓ يمكن للتجار إزالة تثبيت تطبيقك في أي وقت — وينتهي الوصول فورًا، في كل مكان
أطلق أسرع بالأدوات الرسمية
App Bridge
مكتبة المتصفح للصفحات المضمّنة: رموز الجلسة، والتنقل، والإشعارات المنبثقة، وأدوات الاختيار، ونوافذ التأكيد.
حزمة تطوير Node
عميل خادم بأنواع TypeScript كاملة لواجهة OAuth، مع إعادة المحاولة وتبادل الرموز والتحقق من رموز الجلسة وتوقيعات webhooks.
حزمة تطوير Functions
أنواع لكتابة الوظائف المُستضافة، مع مشغّل محلي لاختبار الوظيفة قبل نشرها.
واجهة سطر الأوامر
أنشئ هيكل تطبيق، وانشر الوظائف المُستضافة واختبرها على بيئة تجريبية، وادفع الإصدارات الجديدة — كل ذلك من طرفيتك.
قالب انطلاق
تطبيق مضمّن جاهز للتشغيل تُنشئه لك واجهة سطر الأوامر — OAuth وApp Bridge وإجراء وبطاقة على الفاتورة ومستقبِل webhooks ووظيفة مُستضافة نموذجية، موصولة بالفعل.
حزم التطوير وواجهة سطر الأوامر في مرحلة المعاينة: ثبّتها من الشيفرة المصدرية إلى أن تُنشر على npm.
تطبيقك، أمام كل تاجر على OneBooks.
أنشئ حساب مطوّر مجانيًا، وابنِ مقابل بيئة تجريبية، وانشر في متجر يثق به التجار بالفعل.