عمر ستور
🔌 API v2

شرح الـAPI للمطوّرين

اسحب منتجاتنا وبيعها لعملاءك بأسعار التجّار — الشرا أوتوماتيك من رصيد محفظتك فى الموقع، والحسابات الجاهزه بتتسلّم فى نفس اللحظه.

🚀 البدايه فى ٣ خطوات

  1. اعمل حساب أو ادخل، وافتح «حسابى» ← API ودوس «اعمل مفتاحك».
  2. اشحن محفظتك بأى طريقة دفع — كل شرا من الـAPI بيتخصم منها.
  3. ابعت نداءاتك على الرابط ده بالمفتاح فى الهيدر:
https://omarstore.net/api/v2          ← EGP
https://omarstore.net/api/v2/usd      ← USD

نسخة /usd = نفس الـAPI بالظبط والأرقام بالدولار (لبرامج المتاجر اللى بتفترض الدولار).

🧩 متجرك ووردبريس (ووكومرس)؟

مش محتاج تكتب كود: نزّل الإضافة الجاهزة، وارفعها من «إضافات» ← «إضافة إضافة» ← «رفع إضافة»، وحط مفتاحك فى «WooCommerce» ← «عمر ستور»، واختار فى كل منتج المنتج المقابل عندنا. الشرا والتسليم للعميل والتنبيهات بيتعملوا لوحدهم.

ماتستخدمش صفحة ووكومرس «الإعدادات ← متقدم ← Webhooks» للربط — دى بتبعت فى الاتجاه العكسى وبتطلّع خطأ 404.

🔑 المفتاح

ابعته فى هيدر X-API-Key، أو Authorization: Bearer <المفتاح>.

curl https://omarstore.net/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://omarstore.net/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://omarstore.net/api/v2/products

curl -X POST https://omarstore.net/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://omarstore.net/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://omarstore.net/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://omarstore.net/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://omarstore.net/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)