§ DEVELOPERS · REST · JSON

ابنِ على نُمُو.

متجرك متاح كـ REST API: المنتجات، الأوردرات، الشحن، الفواتير والعملاء. اعمل توكن بصلاحيات محددة، اشترك في الأحداث، وابني أدواتك.

§ REST

REST + JSON

URLs متوقّعة، HTTP verbs معيارية، JSON في كل مكان.

§ WEBHOOKS

Webhooks

رسائل موقّعة وبتتعاد لو فشلت، لأحداث الأوردرات والدفع والمنتجات. تقدر تجربها وتغيّر السر من الـ API.

§ TOKENS

توكنات بصلاحيات محددة

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

§ REFERENCE

مرجع الـ API مباشر

ملف OpenAPI بيتولد من الـ API نفسه — وصّل عليه مولّد الكلاينت بتاعك.

مثال سريع

# Send every paid order to your own system.
# NUMU_TOKEN is a scoped token you minted in the dashboard.

curl -X POST \
  https://numueg.app/api/v1/stores/$STORE_ID/webhooks \
  -H "Authorization: Bearer $NUMU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://erp.example.com/hooks/numu",
    "events": ["order.paid", "order.status_changed"],
    "description": "ERP sync"
  }'

# =>
# {
#   "id": "8f2b...",
#   "events": ["order.paid", "order.status_changed"],
#   "is_active": true,
#   "secret": "shown once — sign every delivery with it"
# }

# Each delivery carries:
#   X-NUMU-Event:        order.paid
#   X-NUMU-Delivery:     <id, stable across retries>
#   X-NUMU-Signature-V1: t=<unix>,v1=<hmac sha256 of "t.body">

نظرة على الـ endpoints

v1
POST/api/v1/public/waitlistتسجيل الإيميل في قائمة أول ١٠٠ تاجر.
POST/api/v1/public/contactطلب تواصل أو مكالمة.
GET/api/v1/public/pricing-plansعرض الباقات والمميزات والعروض النشطة.
POST/api/v1/auth/registerإنشاء حساب تاجر — يرجع access token.
POST/api/v1/stores/{store_id}/access-tokensإنشاء توكن API بصلاحيات محددة. السر بيظهر مرة واحدة بس.
GET/api/v1/stores/{store_id}/orders/عرض الأوردرات مع فلاتر، تصفح، وتجميع حسب الحالة.
POST/api/v1/stores/{store_id}/shipments/waybillsإنشاء بوليصة شحن لأوردر — بدون ملء فورم.
GET/api/v1/stores/{store_id}/invoices/by-order/{order_id}جيب الفاتورة الإلكترونية المعتمدة من ETA لأوردر.
POST/api/v1/stores/{store_id}/webhooksاشترك بـ endpoint في أحداث الأوردرات والمنتجات.

المرجع الكامل: /api/v1/public/docs

§ EARLY ACCESS

الـ API في Beta خاص

بنضم مطورين مؤسسين يساعدونا نصيغ الـ API. عايز تدخل الباتش الأول؟

اطلب الوصولتصفّح الـ App Store

نستخدم ملفات تعريف الارتباط لتحسين تجربتك. باستخدامك للموقع، أنت توافق على سياسة الخصوصية.

الخصوصية