تاجر
ابدأ مجاناً

المطورون

ابدأ مع واجهة المطورين

أنشئ زوج مفاتيح من لوحة التاجر ونفّذ أول طلب قراءة على متجرك بأمر curl واحد.

توثيق OpenAPIأمان Webhooks

أول طلب API

تحتاج إلى زوج مفاتيح: المعرّف (x-api-key) والسر (x-api-secret) معًا في كل طلب.

  1. من لوحة التاجر افتح الإعدادات ← المطورون وأنشئ مفتاحًا جديدًا مع الصلاحيات التي تحتاجها فقط.
  2. انسخ السر فور إنشائه واحفظه في مكان آمن، ولا تضعه في كود يعمل في المتصفح.
  3. نفّذ الطلب التالي:

curl

curl https://<api-host>/api/v1/developer/store \
  -H "x-api-key: <key-id>" \
  -H "x-api-secret: <secret>"

قائمة المنتجات من Node.js

fetch

const res = await fetch(
  "https://<api-host>/api/v1/developer/products?page=1&perPage=25",
  {
    headers: {
      "x-api-key": process.env.TAJER_API_KEY,
      "x-api-secret": process.env.TAJER_API_SECRET,
    },
  },
);
const body = await res.json();
if (!body.success) throw new Error(body.error.code);
console.log(body.data, body.meta);

الصلاحيات (Scopes)

كل مفتاح يحمل صلاحيات مثل read_products وread_orders وwrite_products. الطلب خارج صلاحيات المفتاح يُرفض، فامنح الحد الأدنى فقط.

مرجع OpenAPI

كل المسارات والحقول موثقة في واجهة OpenAPI التفاعلية على /api/docs/ui في خادم الـ API.

/api/docs/ui

استجابة النجاح

200

{ "success": true, "data": [ ... ], "meta": { ... } }

القوائم تعيد meta للترقيم.

استجابة الخطأ

4xx / 5xx

{ "success": false, "message": "...", "error": { "code": "...", "message": "..." } }

تحقق من success أولًا ثم تعامل مع error.code.

جاهز تبدأ؟

توثيق OpenAPIمركز المطورين