موقعك يعرض كميات خاطئة، ومحاسبك يعيد إدخال الفواتير في أداته، وتطبيقك الخاص لا يعرف شيئًا عن زبائنك: برامجك لا تتحاور، وموظفوك هم من يربط بينها يدويًا. وحدة الواجهة البرمجية API في الموارد تفتح بياناتك لمطوّريك بقواعد واضحة: ما يمكن للمفتاح قراءته، وما يمكنه كتابته، وبأي وتيرة.
برامج لا تتحاور وموظفون ينسخون
المؤسسة التي تكبر تنتهي غالبًا بثلاث أدوات أو أربع: موقع أو متجر إلكتروني، وتطبيق خاص مطوَّر حسب الطلب، وجدول متابعة، وبرنامج التسيير. وبينها جسر واحد: شخص ينسخ. فتتراكم أخطاء الإدخال، وتختلف الأرقام من أداة إلى أخرى، ولا يعود أحد يعرف أيها يصدّق.
وربط برنامجين يخيف أيضًا، وعن حق: مفتاح وصول يُسلَّم لمقدّم خدمة أو يُنسى في شيفرة موقع قد يصبح بابًا مفتوحًا على مخزونك وفواتيرك. يجب أن تربط دون أن تكشف كل شيء.
واجهة برمجية تتبع قواعد شاشاتك نفسها
واجهة الموارد البرمجية من نوع REST عبر HTTPS وبصيغة JSON. تغطي الفوترة (الفواتير وعروض الأسعار والفواتير الشكلية وطلبيات الزبائن ووصولات التسليم والفواتير التعديلية والدفعات والزبائن)، والمخزون والمشتريات (المنتجات بكمياتها في الوقت الحقيقي، والحركات والمستودعات والجرد والمورّدين والمشتريات)، والموارد البشرية (العمال، وكشوف الأجور للقراءة، والعقود والحضور والتسبيقات). وكل نداء يمر بالرقابة نفسها التي في الشاشة: الفاتورة المرقّمة لا تعود مسودة، والخروج الذي يجعل المخزون سالبًا مرفوض، وكل كتابة إما تتم كاملة أو لا تتم.
والأمان مضبوط افتراضيًا. المفتاح الجديد لا يفعل إلا القراءة، ونمط القراءة والكتابة يُفعَّل بطلب منك. ورمز الموظف لا يفعل إلا ما تسمح به شاشته. والنداءات محدودة بـ20 في الدقيقة و500 في اليوم لكل رمز. وبدل مساءلة الواجهة باستمرار، يمكن لنظامك أن يستقبل إشعارات Webhooks: نداء موقّع بـHMAC-SHA256 إلى عنوان HTTPS حين تُدفع فاتورة، أو تتغير حالتها، أو يُنشأ زبون.
كيف يعمل، في خمس شاشات
- البدء في ٣ خطوات: تُفعَّل الوحدة عند الطلب، ثم تعرض صفحة التوثيق رمزك وأمثلة جاهزة للنسخ بـcURL وPython وPHP.
- الحصول على رمزك: يكفي ترويسة واحدة، Authorization: Token متبوعة بالرمز، وتحفظه سرًا ككلمة السر.
- نقاط الوصول: قائمة المسارات حسب المجال، ولكل منها مستوى الوصول المطلوب والمعاملات ومثال طلب واستجابة.
- الإشعارات الآلية (Webhooks): القسم الذي يشرح كيف تصرّح، بنداء إلى الواجهة، بعنوان HTTPS والأحداث المطلوبة؛ يظهر سر التوقيع مرة واحدة، وتعرض قائمة الإشعارات آخر حالة وعدد الإخفاقات لكل منها.
- ما ترد به واجهة البرمجة: جدول رموز الاستجابة من 200 إلى 429، ولكل رمز ما يجب فعله.
ما الذي تربحه
- موقع يقول الحقيقة. الكميات والأسعار تُقرأ في الوقت الحقيقي، لا من تصدير الأمس.
- إعادة إدخال أقل. زبون أو وثيقة أُنشئا في مكان آخر يدخلان مباشرة إلى الموارد بالرقابة نفسها التي في الشاشة.
- مفاتيح لا تتجاوز حدودها. قراءة فقط افتراضيًا، واحترام صلاحيات الموظف، وسقف نداءات لكل رمز.
- تكامل يتفاعل. إشعارات Webhooks تُعلم نظامك بدفع الفاتورة دون مساءلة مستمرة.
- توثيق واضح. أمثلة بـcURL وPython وPHP، وجدول أخطاء يقول ما يجب فعله.
لمن هذه الوحدة؟
تتوجه الوحدة إلى المؤسسات التي لديها مطوّر أو مقدّم خدمات إعلام آلي أو تطبيق خاص تريد ربطه. أما الاستعمال العادي للموارد، من تطبيق الهاتف ومركز سطح المكتب وأجهزة تسجيل الحضور البيومترية، فلا يحتاجها. ولمتجر WooCommerce، تتكفل وحدة التجارة الإلكترونية بالمزامنة دون أي تطوير.
- مؤسسات لها موقع أو تطبيق مطوَّر حسب الطلب
- ناشرو البرمجيات المهنية والمدمجون
- موزعون مرتبطون بشبكة بائعيهم
- مجمّعات توحّد عدة أدوات
- مديريات الإعلام الآلي التي تغذي لوحات القيادة
أسئلة شائعة
هل أحتاج هذه الوحدة لتطبيق الهاتف أو لمركز سطح المكتب؟
لا. التطبيق ونسخة Desktop وأجهزة الحضور البيومترية تعمل دونها. الوحدة لا تخدم إلا ربط أدواتك أنت.
هل يستطيع مفتاح مسروق تعديل بياناتي؟
المفتاح الجديد للقراءة فقط: لا يُنشئ ولا يعدّل. ونمط الكتابة لا يُفعَّل إلا بطلب منك، ويبقى كل رمز محدودًا بصلاحيات المستخدم الذي أنشأه. ولا تنشر رمزًا أبدًا في الشيفرة الظاهرة لصفحة ويب.
ما الأحداث التي تُطلق إشعار Webhook؟
ثلاثة اليوم: دفع فاتورة، وتغيّر حالة فاتورة، وإنشاء زبون. يتم الإرسال في محاولة واحدة وبمهلة قصيرة، والإشعار الذي يفشل 20 مرة متتالية يتوقف وحده، وتتيح الواجهة استدراك حدث فائت.
ما حدود النداءات؟
20 نداءً في الدقيقة و500 في اليوم لكل رمز، قراءة وكتابة معًا. وبعدها ترد الواجهة بالرمز 429 فيجب تباعد النداءات. والقوائم تُقرأ بصفحات من 100 عنصر، وحتى 200 في الصفحة.
هل يمكن إعداد كشف أجر عبر الواجهة البرمجية؟
لا، وهذا مقصود: كشوف الأجور تُقرأ عبر الواجهة لكنها تُعد في الشاشة، حيث تُراجع السلالم والغيابات والتسبيقات.
شاهد وحدة الواجهة البرمجية API على حالتك أنت
تعال إلى العرض التوضيحي مع مطوّرك وقائمة البيانات التي يجب أن يقرأها موقعك أو برنامجك أو يكتبها: نتحقق معًا، مسارًا بمسار، مما تغطيه الواجهة البرمجية اليوم.
- العرض التوضيحي. يعرض عليك مستشار وحدة الواجهة البرمجية API على نشاطك، عبر الإنترنت وعلى شاشتك، ويجيب عن أسئلتك. اطلب عرضًا توضيحيًا.
- النسخة التجريبية. تُفعَّل مع مستشار أثناء العرض، على حسابك الخاص: منتجاتك الحقيقية وزبائنك الحقيقيون، و14 يومًا للعمل عليها. أنشئ حسابك لتطلبها.
- ورشات التخصيص. خلال فترة التجربة نكيّف معك الشاشات والوثائق والإعدادات حسب طريقة عملك. هذه الورشات مجانية.
وحدة الواجهة البرمجية API تُفتح عند الطلب: اطلبها أثناء العرض، يعطيك المستشار سعرها، ولا تدفع إلا إذا قررت المواصلة. الباقات الأساسية في صفحة الأسعار.
اطلب العرض عبر واتساباطلب عرضًا توضيحيًا