API Reference

Hajatek API

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

البدء السريع

عنوان الـ API الأساسي

https://api.hajatek.com/v1

المصادقة

استخدم مفتاح API الخاص بك من لوحة التحكم. أرسله كـ Bearer token في ترويسة Authorization.

Authorization: Bearer YOUR_API_KEY

حدود الاستخدام

يعتمد حد الطلبات على باقتك:

مبتدئ
100 طلب/دقيقة
متقدم
500 طلب/دقيقة
احترافي
غير محدود

صيغة الاستجابة

جميع الاستجابات ترجع بصيغة JSON مع ترويسة Content-Type: application/json.

نقاط النهاية الأساسية

GET/stores/{store_id}
الحصول على معلومات المتجر
GET/products
عرض قائمة المنتجات
المعاملات: page, limit, category, search
POST/products
إنشاء منتج جديد
PUT/products/{id}
تحديث منتج
DELETE/products/{id}
حذف منتج
GET/orders
عرض قائمة الطلبات
المعاملات: status, page, limit
GET/orders/{id}
الحصول على تفاصيل طلب
PUT/orders/{id}/status
تحديث حالة طلب
GET/customers
عرض قائمة العملاء
GET/analytics/summary
الحصول على تحليلات المتجر

الـ Webhooks

استقبل إشعارات فورية عند حدوث أحداث في متجرك. سجّل عنوان URL في لوحة التحكم لتلقي طلبات POST تلقائية.

الأحداث المتاحة

order.createdعند إنشاء طلب جديد
order.updatedعند تحديث طلب
payment.completedعند اكتمال عملية دفع
product.createdعند إنشاء منتج جديد
inventory.lowعند انخفاض المخزون

مثال على حمولة الـ Webhook

{
  "id": "evt_1234567890",
  "type": "order.created",
  "created_at": "2026-03-15T12:00:00Z",
  "data": {
    "order_id": "ord_abc123",
    "store_id": "str_xyz789",
    "total": 299.99,
    "currency": "SAR",
    "status": "pending",
    "items": [
      {
        "product_id": "prod_001",
        "name": "Premium Widget",
        "quantity": 2,
        "price": 149.99
      }
    ]
  }
}

التحقق من التوقيع

كل طلب webhook يتضمن ترويسة X-Hajatek-Signature تحتوي على توقيع HMAC-SHA256. تحقق من التوقيع باستخدام مفتاح الـ webhook السري الخاص بك للتأكد من صحة الطلب.

X-Hajatek-Signature: sha256=a1b2c3d4e5f6...

أمثلة الكود

cURL
curl -X GET "https://api.hajatek.com/v1/products?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
JavaScript / Node.js
const response = await fetch(
  "https://api.hajatek.com/v1/products?page=1&limit=10",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  }
);

const data = await response.json();
console.log(data.products);
Python
import requests

response = requests.get(
    "https://api.hajatek.com/v1/products",
    params={"page": 1, "limit": 10},
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
)

data = response.json()
print(data["products"])

تكامل وكلاء الذكاء الاصطناعي

اربط متجرك بوكلاء الذكاء الاصطناعي مثل Claude و ChatGPT عبر بروتوكول MCP.

استكشف توثيق MCP→