Recipe ·وصفة

افحَص عميلاً، وتحقّق من أهليّته، وافوترْه.
ثلاث جهات. ثلاثة استدعاءات. مفتاحٌ واحد.

هذا مثال توضيحي غير تنفيذي. يجب تأكيد توفر الخدمة والموافقات والأسعار والنتائج لحسابك. تتحقّق من هويّته لدى سدايا، وتقرأ حالته الوظيفيّة من قوى، ثمّ تُصدِر له فاتورةً ضريبيّة عبر زاتكا. ثلاث جهاتٍ حكوميّة في دالّةٍ واحدة.

The alternative ·البديل

ولو ربطتَ كلّ جهةٍ مباشرةً؟

هذا سؤالٌ عادل، وهو البديل الحقيقيّ لا منافسٌ آخر. الفرق ليس في وجود الواجهة — كلّها موجودة — بل في ما تحمله أنت عنها.

ربطٌ مباشر بكلّ جهةAPI360
العقود والاتّفاقيّاتثلاثةواحد
آليّات المصادقةثلاث مختلفةمفتاحٌ واحد
الفواتير الشهريّةثلاثواحدة
حين تتغيّر واجهةُ جهةتكتشفه من الأعطالإشعار داخل التطبيق وعبر البريد

ولا نُخفي الجانب الآخر: الربط المباشر يُلغي وسيطاً ويمنحك علاقةً مباشرةً بالجهة. وإن كنت تستهلك واجهةً واحدةً فقط ولا تنوي غيرها، فالفارق أضيق ممّا يبدو.

The three calls ·الاستدعاءات الثلاثة

خطوةً خطوة.

١

تحقّق من الهويّة سدايا

رقم الهويّة وتاريخ الميلاد يعودان باسمٍ مطابقٍ وحالة سريان. لا تُخزَّن الهويّة كاملةً في سجلّك — يُحفَظ المرجع والنتيجة فقط.

POST /v1/identity/verifyتوضيحي فقط
٢

اقرأ الحالة الوظيفيّة قوى

بموافقة صاحب البيانات: جهة العمل وحالة العقد. تكفي لقرار أهليّةٍ تمويليّ أو حدّ ائتمان — بلا كشف راتبٍ ولا مستندات.

GET /v1/employment/statusتوضيحي فقط
٣

أصدِر الفاتورة زاتكا

فاتورةٌ ضريبيّة مطابقة للمرحلة الثانية، مُوقَّعةٌ ومُبلَّغٌ عنها. تعود إليك بـuuid ورمز QR جاهزٍ للطباعة.

POST /v1/zatca/einvoiceتوضيحي فقط
حُذفت الأسعار ونتائج التنفيذ عمدًا لأن هذا المثال ليس تجربة تنفيذية معتمدة.
The code ·الشيفرة

الوصفة كاملةً.

# المفتاح نفسه لكلّ منتج مشترك به تطبيقك — مثال توضيحي
curl -X POST "<identity-gateway-url>/v1/<endpoint>" \
  -H "api360key: $API360_KEY" \
  -d '{"<field>":"<value>"}'

curl "<employment-gateway-url>/v1/<endpoint>?<param>=<value>" \
  -H "api360key: $API360_KEY"

curl -X POST "<invoicing-gateway-url>/v1/<endpoint>" \
  -H "api360key: $API360_KEY" \
  -d '{"<field>":"<value>"}'
ما لا تراه في الشيفرة: كلّ استدعاء يمرّ عبر البوّابة التي تتحقّق من اشتراكك وحصّتك قبل أن يصل الطلب إلى المزوّد.