ابنِ على دفاترك عبر واجهة REST حديثة
وصول برمجي إلى العملاء والفواتير والمشتريات والمدفوعات والبنوك والمخزون والمحاسبة وإدارة العملاء. أنشئ مفتاح واجهة برمجة محدّد النطاق، واقرأ بياناتك واكتبها، واربط WisoBooks بأي تطبيق أو أداة خارجية.
# Create an invoice with your API key curl -X POST https://api.wisobooks.com/v1/orders \ -H "Authorization: Bearer bk_live_…" \ -H "Idempotency-Key: 7f3a-1" \ -H "Content-Type: application/json" \ -d '{ "customerId": "…", "issueDate": "2026-06-27" }' # → 201 Created · ETag, RFC 9457 errors, pagination, rate limits
مفاتيح واجهة برمجة آمنة ومحدّدة النطاق — تُصدَر بعد تسجيل الدخول
أنشئ المفاتيح من بوّابة المطوّرين. كل مفتاح مرتبط بحسابك ويحمل نطاقات على نمط OAuth لا يمكنها إلا تضييق ما تستطيع فعله أصلًا — لا توسيعه أبدًا. تُخزَّن الأسرار مُجزّأة، وترى المفتاح كاملًا مرة واحدة فقط.
- ترويسة Authorization: Bearer أو X-Api-Key
- نطاقات عامة مثل customers:read أو orders:write أو * للوصول الكامل
- سقف طلبات لكل مفتاح، وتاريخ انتهاء، وإلغاء بنقرة واحدة
- مفاتيح تشغيل واختبار ببادئتين مختلفتين bk_live_ و bk_test_
GET https://api.wisobooks.com/v1/me
{
"tenantId": "…",
"environment": "Live",
"scopes": ["customers:read","orders:write"],
"permissions": ["Permissions.Customers.View", …]
}
كل جزء من نشاطك، على هيئة موارد REST
موارد JSON متّسقة مع قوائم مُقسّمة إلى صفحات، وETags للتزامن المتفائل، وIdempotency-Key عند الإنشاء، وأخطاء بصيغة RFC 9457 في كل مكان.
- المبيعات: العملاء والطلبات/الفواتير وعروض الأسعار ومدفوعات العملاء وإشعارات الدائن
- المخزون: الأصناف والمجموعات والمستودعات ووحدات القياس
- المشتريات: المورّدون وفواتير الشراء وأوامر الشراء والمصروفات ومدفوعات المورّدين
- المحاسبة والضرائب: الضرائب ومجموعات الضرائب والأصول الثابتة
- البنوك: الحسابات البنكية والحركات
- إدارة العملاء: العملاء المحتملون وجهات الاتصال والفرص والأنشطة
{
"data": [ { "id": "…", "name": "Acme Co", "dueAmount": 1200 } ],
"meta": { "page": 1, "pageSize": 50,
"totalCount": 348, "totalPages": 7 }
}
توثيق تفاعلي مُولَّد من الواجهة البرمجية الحيّة
مستند OpenAPI 3.1 يشغّل مرجع Scalar مع وحدة تجربة مدمجة — الصق مفتاحًا، ونفّذ أي نقطة نهاية، وانسخ الطلب بصيغة curl أو باللغة التي تختارها.
- مستند Microsoft OpenAPI على /openapi/v1.json
- مرجع Scalar لواجهة البرمجة مع المصادقة والتجربة المباشرة
- ولّد عملاء بأي لغة انطلاقًا من مواصفة OpenAPI
- قواعد متوقَّعة للتقسيم إلى صفحات والفرز والبحث
# Rate limits & quota are returned as headers
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/problem+json
ابدأ مجانًا وتوسّع مع الاستخدام
تسعير مختلط: كل فئة تشمل حصة استدعاءات شهرية وسقفًا للطلبات، والفئات المدفوعة تُحاسب على الاستهلاك الإضافي لكل ١٬٠٠٠ استدعاء. الفئة المجانية دائمة، مع تجربة ١٤ يومًا لفئة Pro للحسابات الجديدة.
- مجاني — ١٬٠٠٠ استدعاء شهريًا، ٦٠ طلبًا في الدقيقة
- Starter — ٥٠٬٠٠٠ استدعاء شهريًا، ٣٠٠ طلب في الدقيقة، استهلاك إضافي ١ دولار لكل ١٬٠٠٠
- Pro — ٥٠٠٬٠٠٠ استدعاء شهريًا، ٦٠٠ طلب في الدقيقة، استهلاك إضافي ٠٫٥٠ دولار لكل ١٬٠٠٠
- المؤسسات — حصة مخصّصة وحدود خاصة واتفاقية مستوى خدمة
الأسئلة الشائعة
كيف أُجري المصادقة؟
أنشئ مفتاح واجهة برمجة من بوّابة المطوّرين وأرسله في ترويسة Authorization: Bearer (أو X-Api-Key). نطاق المفاتيح محدود بصلاحياتك.
هل توجد بيئة اختبار؟
نعم — مفاتيح bk_test_ تعمل على شركة اختبار معزولة ببيانات تجريبية. استدعاءات بيئة الاختبار مجانية ولا تُحتسب ضمن الحصة أبدًا.
ماذا عن حدود الطلبات؟
كل خطة تحدّد سقفًا للطلبات في الدقيقة وحصة شهرية. تجاوزهما يعيد 429 مع Retry-After، وتجاوز الحصة يعيد 402/429 ما لم يكن الاستهلاك الإضافي مفعّلًا.
هل يمكنني توليد حزمة تطوير للعميل؟
نعم. يتيح لك مستند OpenAPI 3.1 توليد عملاء بأنواع محدّدة بأي لغة، أو استخدام وحدة التجربة في Scalar مباشرة.
جاهز للبناء؟
سجّل الدخول إلى بوّابة المطوّرين، وأنشئ مفتاحًا، ونفّذ أول استدعاء خلال دقائق.