شرح الـAPI للمطوّرين
اسحب منتجاتنا وبيعها لعملاءك بأسعار التجّار — الشرا أوتوماتيك من رصيد محفظتك فى الموقع، والحسابات الجاهزه بتتسلّم فى نفس اللحظه.
🚀 البدايه فى ٣ خطوات
- اعمل حساب أو ادخل، وافتح «حسابى» ← API ودوس «اعمل مفتاحك».
- اشحن محفظتك بأى طريقة دفع — كل شرا من الـAPI بيتخصم منها.
- ابعت نداءاتك على الرابط ده بالمفتاح فى الهيدر:
https://shop.ejaz.media/api/v2 ← EGP https://shop.ejaz.media/api/v2/usd ← USD
نسخة /usd = نفس الـAPI بالظبط والأرقام بالدولار (لبرامج المتاجر اللى بتفترض الدولار).
🧩 متجرك ووردبريس (ووكومرس)؟
مش محتاج تكتب كود: نزّل الإضافة الجاهزة، وارفعها من «إضافات» ← «إضافة إضافة» ← «رفع إضافة»، وحط مفتاحك فى «WooCommerce» ← «عمر ستور»، واختار فى كل منتج المنتج المقابل عندنا. الشرا والتسليم للعميل والتنبيهات بيتعملوا لوحدهم.
ماتستخدمش صفحة ووكومرس «الإعدادات ← متقدم ← Webhooks» للربط — دى بتبعت فى الاتجاه العكسى وبتطلّع خطأ 404.
🔑 المفتاح
ابعته فى هيدر X-API-Key، أو Authorization: Bearer <المفتاح>.
curl https://shop.ejaz.media/api/v2/me \ -H "X-API-Key: sk_xxxxxxxxxxxxxxxx"
⚠️ المفتاح زى كلمة السر: استخدمه من السيرفر بتاعك بس — ماتحطّهوش فى صفحه العميل بيفتحها، ولو حسّيت إنه اتسرّب غيّره من «حسابى» فورًا.
📋 الأوامر
| الأمر | بيعمل إيه |
|---|---|
GET /products | كل المنتجات المتاحه بسعرك (سعر الـAPI) والمخزون والفئه والوصف. إصدارات الألعاب والبطاقات والشحن (آلاف المنتجات) مش فيها — ضيف ?games=1 لو عاوزها. |
GET /products/{id} | منتج واحد. |
POST /purchase | تشترى برصيدك — الفورى بيرجع حسابه فى الرد على طول. |
GET /orders/{id} | حالة طلب والحساب المسلّم. |
GET /orders | طلباتك (الأحدث الأول) — ?limit=50&since_id=0 |
GET /balance · GET /me | رصيدك وحالة حسابك. |
POST /webhook · GET · DELETE | رابط عندك بنبلّغه لما طلب يتفعّل أو يترجّع. |
🛒 الشرا
POST https://shop.ejaz.media/api/v2/purchase
X-API-Key: sk_...
Content-Type: application/json
{
"product_id": 12,
"quantity": 1,
"request_id": "order-1001",
"input": "[email protected]"
}
request_id: رقم الطلب عندك — ابعته دايمًا. لو النت قطع وأعدت نفس النداء بنفس الرقم، بيرجعلك نفس الطلب من غير ما يتخصم منك تانى (أو هيدرIdempotency-Key).input: بس للمنتجات اللىneeds_input: true— زى إيميل العميل اللى هيتفعّل عليه الاشتراك.
الرد:
{
"success": true,
"order_id": 5231,
"status": "delivered",
"state": "completed",
"product": "Netflix Premium 1M",
"quantity": 1,
"paid": 150.0,
"currency": "EGP",
"codes": ["[email protected]:password"],
"balance_after": 850.0,
"duplicate": false
}
state: completed اتسلّم · pending بيتفعّل · processing بيتجهّز · cancelled/refunded رصيدك رجع.
💻 أمثله جاهزه
cURL
curl -H "X-API-Key: sk_..." https://shop.ejaz.media/api/v2/products
curl -X POST https://shop.ejaz.media/api/v2/purchase \
-H "X-API-Key: sk_..." -H "Content-Type: application/json" \
-d '{"product_id": 12, "quantity": 1, "request_id": "order-1001"}'PHP
<?php
$ch = curl_init("https://shop.ejaz.media/api/v2/purchase");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["X-API-Key: sk_...", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["product_id" => 12, "quantity" => 1, "request_id" => "order-1001"]),
]);
$res = json_decode(curl_exec($ch), true);
if (!empty($res["success"])) { $accounts = $res["codes"]; }
else { echo $res["error"]["code"] . " — " . $res["error"]["message"]; }JavaScript (Node.js)
const r = await fetch("https://shop.ejaz.media/api/v2/purchase", {
method: "POST",
headers: { "X-API-Key": "sk_...", "Content-Type": "application/json" },
body: JSON.stringify({ product_id: 12, quantity: 1, request_id: "order-1001" }),
});
const data = await r.json();
if (data.success) console.log(data.codes); else console.log(data.error.code, data.error.message);Python
import requests
r = requests.post("https://shop.ejaz.media/api/v2/purchase",
headers={"X-API-Key": "sk_..."},
json={"product_id": 12, "quantity": 1, "request_id": "order-1001"}, timeout=60)
data = r.json()
print(data["codes"] if data.get("success") else data["error"])🔔 التنبيهات
المنتجات اللى بتتفعّل بإيد المتجر بترجع pending. بدل ما تسأل كل شويه، حط رابط عندك (أو من «حسابى» ← API) وإحنا نبعتلك أول ما الطلب يتفعّل أو يترجّع:
POST https://shop.ejaz.media/api/v2/webhook
{"url": "https://your-site.com/store-callback"}
هيوصلك POST بالشكل ده، ومعاه هيدر X-Signature = sha256= + HMAC-SHA256 للجسم بمفتاحك:
{"event": "order.updated", "order": {"order_id": 5231, "state": "completed", "codes": ["..."], "request_id": "order-1001"}}
// PHP — verify it's from us
$sig = "sha256=" . hash_hmac("sha256", file_get_contents("php://input"), "sk_...");
if (!hash_equals($sig, $_SERVER["HTTP_X_SIGNATURE"] ?? "")) { http_response_code(401); exit; }
رد بـ 200. لو ماردّتش بنعيد كذا مره، وتقدر دايمًا تسأل GET /orders/{id}. الرابط لازم يبدأ بـ https://
❗ الأخطاء
{"success": false, "error": {"code": "...", "message": "..."}}
| code | معناه |
|---|---|
missing_key · invalid_key | المفتاح مش مبعوت أو غلط (401) |
api_disabled · banned | الـAPI مقفول على حسابك (403) |
api_off | الـAPI متوقف مؤقتًا (503) |
insufficient_balance | رصيدك مايكفّيش — اشحن محفظتك |
out_of_stock | المنتج خلص (ولو خلص لحظة التنفيذ المبلغ بيرجع رصيدك — 409) |
invalid_input | البيانات المطلوبه ناقصه أو غلط |
product_not_found · order_not_found | مش موجود (404) |
rate_limited | أكتر من 60 نداء فى الدقيقه (429) |