1 ابدأ في 5 دقائقانسخ القسم Markdown ثلاث خطوات تنتهي بنداء ناجح. كل شيء في البيئة التجريبية مجاني ولا يخصم من رصيد حسابك.
بِع خدماتنا في تطبيقك اعرض الدومينات والاستضافة والبريد بسعرك داخل متجرك أو تطبيقك.
أتمت حسابك جدّد الدومينات وأضف صناديق البريد وغيّر سجلّات DNS من سكربت.
دع مساعدك الذكي يديره يقرأ الحالة ويجهّز لك الشراء وأنت تؤكّد، عبر MCP والمهارات.
أنشئ مفتاحًا تجريبيًا من «لوحة التحكم ← ربط الذكاء والمفاتيح». يظهر السرّ مرة واحدة فقط، فاحفظه. أول نداء وقّع الطلب وأرسل ping. إن رجع ok فمفتاحك وتوقيعك صحيحان. انتقل إلى المفتاح الحي حين تنتهي من التجربة تطلب اعتماد تطبيقك، ثم تبدّل المفتاح فقط. لا تغيّر كودك. أنشئ مفتاحًا تجريبيًا بيانات تجريبية مفتاحك التجريبي (مثال) sy_test_••••c91مثال شكلي: لا يُنشأ مفتاح حقيقي في هذا التصميم. في الواقع يظهر السرّ مرة واحدة.
أول نداء curl JavaScript Python PHP
نسخ # 1) وقّع الطلب (التفاصيل في قسم المصادقة)
TS=$(date +%s)
SIG=$(printf 'v2\n%s\n%s\n%s\n%s' "$TS" GET /api/v1/ping "" | openssl dgst -sha256 -hmac "$SECRET" -r | cut -d' ' -f1)
# 2) أرسل
curl https://syriana.store/api/v1/ping \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" نسخ import crypto from "node:crypto";
const ts = String(Math.floor(Date.now() / 1000));
const path = "/api/v1/ping";
const sig = crypto.createHmac("sha256", process.env.SY_SECRET)
.update(["v2", ts, "GET", path, ""].join("\n")).digest("hex");
const r = await fetch("https://syriana.store" + path, { headers: {
"X-Syriana-Key": process.env.SY_KEY, // sy_test_••••
"X-Syriana-Timestamp": ts,
"X-Syriana-Signature-Version": "2",
"X-Syriana-Signature": sig,
}});
console.log((await r.json()).data); نسخ import hashlib, hmac, os, time, requests
ts, path = str(int(time.time())), "/api/v1/ping"
sig = hmac.new(os.environ["SY_SECRET"].encode(),
"\n".join(["v2", ts, "GET", path, ""]).encode(),
hashlib.sha256).hexdigest()
r = requests.get("https://syriana.store" + path, headers={
"X-Syriana-Key": os.environ["SY_KEY"], # sy_test_••••
"X-Syriana-Timestamp": ts,
"X-Syriana-Signature-Version": "2",
"X-Syriana-Signature": sig,
})
print(r.json()["data"]) نسخ <?php
$ts = (string) time();
$path = "/api/v1/ping";
$sig = hash_hmac("sha256", implode("\n", ["v2", $ts, "GET", $path, ""]), getenv("SY_SECRET"));
$ch = curl_init("https://syriana.store" . $path);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [
"X-Syriana-Key: " . getenv("SY_KEY"), // sy_test_••••
"X-Syriana-Timestamp: $ts",
"X-Syriana-Signature-Version: 2",
"X-Syriana-Signature: $sig",
]]);
echo curl_exec($ch); عنوان الواجهة اليوم syriana.store/api/v1 ، والعنوان النهائي [يؤكّده المالك]
2 المصادقة والأمانانسخ القسم Markdown كل طلب يحمل مفتاحك وتوقيعًا يثبت أنه منك ولم يُعدَّل. هكذا لا يستطيع أحد إعادة إرسال طلبك أو تغييره.
مفتاح تجريبي ومفتاح حي المفتاح التجريبي يبدأ بـ sy_test_ : كتالوج وأسعار حقيقية، ولا خصم ولا مخزون. الحي يخصم من رصيد حسابك ويحتاج اعتماد تطبيقك. السرّ لا يظهر بعد إنشائه.
التوقيع v2 بكلمات بسيطة تجمع خمسة أسطر: v2 والوقت والطريقة والمسار والجسم، وتوقّعها بسرّك بخوارزمية HMAC-SHA256. الخادم يعيد الحساب ويقارن. الطلب ينتهي بعد 5 دقائق ولا يُقبل مرتين.
curl JavaScript Python PHP
نسخ TS=$(date +%s)
SIG=$(printf 'v2\n%s\n%s\n%s\n%s' "$TS" POST /api/v1/orders "$BODY" \
| openssl dgst -sha256 -hmac "$SECRET" -r | cut -d' ' -f1) نسخ const toSign = ["v2", ts, "POST", "/api/v1/orders", body].join("\n");
const sig = crypto.createHmac("sha256", secret).update(toSign).digest("hex"); نسخ to_sign = "\n".join(["v2", ts, "POST", "/api/v1/orders", body])
sig = hmac.new(secret.encode(), to_sign.encode(), hashlib.sha256).hexdigest() نسخ $sig = hash_hmac("sha256", implode("\n", ["v2", $ts, "POST", "/api/v1/orders", $body]), $secret); الترويسات الأربع X-Syriana-Keyمفتاحك X-Syriana-Timestampالوقت بالثواني X-Syriana-Signature-Version2 X-Syriana-Signatureالتوقيع Idempotency-Key على كل كتابة مفتاح تختاره أنت لكل عملية شراء. إن انقطع الاتصال فأعد الطلب بالمفتاح نفسه: لا يُخصم رصيد حسابك مرتين. لا تستعمل المفتاح نفسه لعمليتين مختلفتين.
أمثلة على الصلاحيات لكل مفتاح صلاحيات محدودة. أعطِ تطبيقك أقلّها. الصلاحية الناقصة تردّ missing_scope . الجدول الكامل ومن يمنح كل صلاحية في قسم «الصلاحيات» بعده.
catalog:readقراءة الكتالوج orders:readقراءة الطلبات orders:writeإنشاء الطلبات licenses:readقراءة التراخيص balance:readقراءة الرصيد balance:writeشحن الرصيد domains:read / writeالدومينات hosting:read / writeالاستضافة mail:read / writeالبريد cloud:read / writeCloudflare merchants:provisionإنشاء حسابات التجّار
حدّ الطلبات الافتراضي 120 طلبًا في الدقيقة لكل تطبيق، ويُحسب على نافذة متحرّكة. عند التجاوز تأتيك 429 مع ترويسة Retry-After . رفع الحدّ يتم بالترقية إلى باقة أعلى.
الأخطاء: ماذا تعني وماذا تفعل الرمز HTTP معناه ماذا تفعل unauthorized401 المفتاح أو التوقيع غير صالح (رسالة واحدة عمدًا). راجع المفتاح والتوقيع والساعة. وقّع طلبًا جديدًا. replayed_request401 هذا الطلب الموقَّع وصل من قبل. وقّع طلبًا جديدًا بوقت جديد، لا تُعد إرسال الطلب نفسه. missing_scope403 مفتاحك لا يملك الصلاحية المطلوبة. أضف الصلاحية لتطبيقك من لوحة التحكم. app_suspended403 التطبيق موقوف. تواصل مع فريق سيريانا. live_only403 هذا النداء يحتاج تطبيقًا معتمدًا للإنتاج. اطلب اعتماد تطبيقك ثم استعمل المفتاح الحي. invalid_json / invalid_request400 الجسم ليس JSON صالحًا أو ينقصه حقل. صحّح الطلب ثم أعد المحاولة. not_found404 العنصر غير موجود. تأكّد من المعرّف. insufficient_funds402 رصيد الحساب لا يكفي لهذا الطلب. اشحن الرصيد ثم أعد الطلب بالمفتاح نفسه Idempotency-Key. conflict_retry409 طلب مماثل ما زال قيد التنفيذ. انتظر ثواني (ترويسة Retry-After) ثم أعد بالمفتاح نفسه. rate_limited429 تجاوزت حدّ الطلبات في الدقيقة. انتظر حسب Retry-After وخفّف الوتيرة. internal_error500 خطأ عندنا. أعد المحاولة بالمفتاح نفسه، وإن تكرّر راسل الدعم.
3 الصلاحيات: ماذا تستطيع أن تفعل ومن يمنحهاانسخ القسم Markdown لكل مفتاح صلاحيات محدودة. بعضها تختاره بنفسك، وبعضها مرتبط بالمال فلا يُفتح إلا بعد توثيق هويّتك أو بمراجعة منّا.
شريك موثَّق بعد توثيق الهوية
مراجعة منّا نمنحها يدويًا لوصلات موثوقة
الكل مطوّر شريك موثَّق مراجعة منّا
الصلاحية ماذا تسمح به من يحصل عليها تحتاج توثيق الهوية catalog:readالكتالوج والأسعار مطوّر لا market:readقراءة عروض السوق مطوّر لا orders:readقراءة الطلبات مطوّر لا balance:readقراءة الرصيد والحركات مطوّر لا domains:read / writeبحث الدومينات وتسجيلها وإدارة DNS (من الرصيد، بسقوف إنفاق) مطوّر لا hosting:read / writeالاستضافة مطوّر لا mail:read / writeبريد الأعمال مطوّر لا cloud:read / writeCloudflare مطوّر لا workspace:read / writeGoogle Workspace مطوّر لا payments:read / writeروابط الدفع وحسابات المزوّدين مطوّر لا branding:writeهوية صفحة الدفع ونطاقها مطوّر لا installments:readقراءة عقود التقسيط مطوّر لا risk:readفحص المشترين (درع سيريانا) مطوّر لا risk:writeالبلاغ والشهادة والتوثيق (للتطبيق الحيّ فقط) مطوّر لا activation:cidرمز التفعيل بالهاتف (من الرصيد) مطوّر لا orders:writeشراء تراخيص من الرصيد شريك موثَّق نعم licenses:readقراءة مفاتيح التراخيص المسلَّمة شريك موثَّق نعم balance:writeفتح شحنة رصيد شريك موثَّق نعم payments:refundإرجاع الدفعات مراجعة منّا نعم installments:writeإنشاء عروض التقسيط مراجعة منّا نعم merchants:kycمراجعة توثيق من زوّدتهم مراجعة منّا نعم merchants:provisionإنشاء حسابات تجّار تلقائيًا مراجعة منّا نعم chat:connectربط Chat Connect (وصلات المنصّات) مراجعة منّا نعم commerce:writeالشراء والتجديد عبر المساعد الذكي (OAuth فقط) مراجعة منّا نعم platform:domainsتشغيل نطاقات صفحات الدفع مراجعة منّا لا
قواعد لا تتغيّر الصلاحية الماليّة لا تُقبل أبدًا من نموذج التطبيق، حتى لو أُرسل طلب مصنوع يدويًا. تطبيق يحمل صلاحية ماليّة لا يُعتمد آليًا للإنتاج، ولا يُعتمد أصلًا قبل توثيق هويّة صاحبه. أدوات المساعد الذكي لا تمنح أبدًا صلاحيات الاسترجاع أو السحب أو الهوية. كيف تطلب صلاحية من لوحة المطوّر ← الصلاحيات : ترى ما مُنح لتطبيقك وما طلبته، وتقدّم التطبيق للمراجعة. تصنيف «من يحصل عليها» مأخوذ من سلوك النظام اليوم، والتسمية النهائية للمستويات تظهر عند الإطلاق.
أسماء balance:* هي الأسماء المعتمدة (كانت wallet:* ).
4 مرجع الـAPIانسخ القسم Markdown مجموعات مرتّبة بما تريد فعله. اضغط أي نقطة لترى طلبها وردّها، وجرّبها بردّ تجريبي.
بيانات تجريبية كل الردود في أزرار «جرّب» أمثلة شكلية. المسارات والصلاحيات هي الحقيقية. كل مسار يبدأ بـ /api/v1 . المجموعات تغطّي الآن كل مجال له واجهة عندنا: المدفوعات والتقسيط والدرع والتوثيق والسوق والمنتجات الرقمية وGoogle Workspace. أما Chat Connect فللوصلات فقط.
الكتالوج والأسعار العملاء والحساب الطلبات التراخيص والمفاتيح الدومينات استضافة المواقع البريد Cloudflare رصيد الحساب روابط الدفع والمدفوعات حساب الدفع وصفحة الدفع التقسيط درع سيريانا وشبكة الحماية توثيق الهوية (KYC) السوق المنتجات الرقمية والتراخيص Google Workspace Chat Connect (للوصلات فقط)
4 نقاط اعرض منتجاتنا بسعر التاجر في متجرك أو تطبيقك.
GET /productsالمنتجات المنشورة بسعر التاجر catalog:read الطلب نسخ curl -X GET https://syriana.store/api/v1/products \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"sku": "OFF24-STD",
"name": "Office 2024 Standard",
"price": "26.95",
"currency": "USD"
}
],
"page": 1
}
} GET /products/{sku}تفاصيل منتج واحد catalog:read الطلب نسخ curl -X GET https://syriana.store/api/v1/products/{sku} \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"sku": "OFF24-STD",
"name": "Office 2024 Standard",
"in_stock": true
}
} GET /categoriesفئات المتجر مع عدد منتجات كل فئة catalog:read الطلب نسخ curl -X GET https://syriana.store/api/v1/categories \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"name": "Office",
"products": 12
}
]
}
} GET /products/changesما تغيّر فقط منذ وقت معيّن catalog:read الطلب نسخ curl -X GET https://syriana.store/api/v1/products/changes \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"since": "2026-10-30T00:00:00Z",
"changed": [
"OFF24-STD"
]
}
} 4 نقاط تحقّق من مفتاحك واعرف صلاحياته، وسجّل عملاءك.
GET /pingهل مفتاحي وتوقيعي صحيحان؟ بلا صلاحية الطلب نسخ curl -X GET https://syriana.store/api/v1/ping \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true,
"env": "test"
}
} GET /meمن أنا وما صلاحياتي بلا صلاحية الطلب نسخ curl -X GET https://syriana.store/api/v1/me \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"app": "My Shop",
"env": "test",
"scopes": [
"catalog:read",
"orders:read"
]
}
} POST /customers/recordسجّل عميلك لديك (لا لدينا) orders:write الطلب نسخ curl -X POST https://syriana.store/api/v1/customers/record \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"name":"Sara","phone":"+9665••••••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"recorded": true
}
} POST /merchants/provisionأنشئ حساب تاجر تلقائيًا عند تثبيت تطبيقك merchants:provision الطلب نسخ curl -X POST https://syriana.store/api/v1/merchants/provision \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"name":"Sara Shop"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"merchant": "m_••••",
"state": "created"
}
} 3 نقاط اشترِ تراخيص ببرمجتك واقرأ حالة طلباتك.
POST /ordersاشترِ تراخيص (يُخصم من رصيد الحساب) orders:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/orders \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"items":[{"sku":"OFF24-STD","quantity":1}]}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"order_id": "ORD-1042",
"state": "fulfilled"
}
} GET /ordersطلباتك عبر الواجهة orders:read الطلب نسخ curl -X GET https://syriana.store/api/v1/orders \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"order_id": "ORD-1042",
"state": "fulfilled"
}
],
"page": 1
}
} GET /orders/{order_id}تفاصيل طلب orders:read الطلب نسخ curl -X GET https://syriana.store/api/v1/orders/{order_id} \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"order_id": "ORD-1042",
"state": "fulfilled",
"total": "26.95"
}
} 2 نقاط اقرأ مفاتيح الطلب وأرسلها لعميلك باسم متجرك.
GET /orders/{order_id}/licensesمفاتيح طلب licenses:read الطلب نسخ curl -X GET https://syriana.store/api/v1/orders/{order_id}/licenses \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"licenses": [
{
"sku": "OFF24-STD",
"key": "XXXXX-••••-••••"
}
]
}
} POST /notify/licenceأرسل المفتاح إلى عميلك بالواتساب أو البريد orders:write الطلب نسخ curl -X POST https://syriana.store/api/v1/notify/licence \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"order_id":"ORD-1042","channel":"whatsapp"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"sent": true
}
} 11 نقاط ابحث وسجّل وجدّد وأدِر السجلّات.
GET /domains/checkهل الاسم متاح وبكم؟ domains:read الطلب نسخ curl -X GET https://syriana.store/api/v1/domains/check?name=mybrand.com \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"name": "mybrand.com",
"available": true,
"price": "14.90"
}
} GET /domains/suggestاقتراحات أسماء domains:read الطلب نسخ curl -X GET https://syriana.store/api/v1/domains/suggest \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
"mybrand.net",
"mybrand.store"
]
}
} GET /domainsدوميناتك domains:read الطلب نسخ curl -X GET https://syriana.store/api/v1/domains \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"name": "mybrand.com",
"expires": "2027-10-31"
}
]
}
} POST /domainsسجّل دومينًا (يُخصم من رصيد الحساب) domains:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/domains \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"name":"mybrand.com","years":1}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"name": "mybrand.com",
"state": "registered"
}
} POST /domains/{name}/renewجدّد دومينًا domains:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/domains/{name}/renew \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"years":1}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"name": "mybrand.com",
"expires": "2028-10-31"
}
} POST /domains/{name}/nameserversغيّر خوادم الأسماء domains:write الطلب نسخ curl -X POST https://syriana.store/api/v1/domains/{name}/nameservers \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"ns":["kai.ns.cloudflare.com","lena.ns.cloudflare.com"]}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} GET /domains/{name}/dnsسجلّات DNS domains:read الطلب نسخ curl -X GET https://syriana.store/api/v1/domains/{name}/dns \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"records": [
{
"type": "A",
"name": "@",
"value": "203.0.113.7"
}
]
}
} POST /domains/{name}/dnsأضف سجلّ DNS أو حدّثه domains:write الطلب نسخ curl -X POST https://syriana.store/api/v1/domains/{name}/dns \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"type":"A","name":"@","value":"203.0.113.7"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /domains/{name}/dns/deleteاحذف سجلّ DNS domains:write الطلب نسخ curl -X POST https://syriana.store/api/v1/domains/{name}/dns/delete \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"type":"TXT","name":"@"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /domains/{name}/forwardوجّه الدومين إلى رابط آخر domains:write الطلب نسخ curl -X POST https://syriana.store/api/v1/domains/{name}/forward \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"target":"https://example.com"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /domains/transferانقل دومينًا إلينا domains:write الطلب نسخ curl -X POST https://syriana.store/api/v1/domains/transfer \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"name":"mybrand.com","auth_code":"••••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"state": "pending"
}
} 5 نقاط اطلب باقة ووردبريس وادخل إلى لوحتها.
GET /hosting/plansالباقات المتاحة hosting:read الطلب نسخ curl -X GET https://syriana.store/api/v1/hosting/plans \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"plan": "starter",
"price": "2.90"
}
]
}
} GET /hostingاستضافاتك hosting:read الطلب نسخ curl -X GET https://syriana.store/api/v1/hosting \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"id": 7,
"domain": "mybrand.com",
"state": "active"
}
]
}
} POST /hostingاطلب استضافة hosting:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/hosting \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"plan":"starter","domain":"mybrand.com"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 7,
"state": "provisioning"
}
} POST /hosting/{id}/loginرابط دخول لمرّة واحدة إلى لوحة الموقع hosting:write الطلب نسخ curl -X POST https://syriana.store/api/v1/hosting/{id}/login \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"url": "https://…/one-time"
}
} POST /hosting/{id}/renewجدّد استضافة hosting:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/hosting/{id}/renew \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 7,
"expires": "2027-10-31"
}
} 6 نقاط صناديق بريد على دومين عميلك (بريد سيريانا للأعمال).
GET /mail/plansالباقات المتاحة mail:read الطلب نسخ curl -X GET https://syriana.store/api/v1/mail/plans \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"plan": "business",
"unit": "mailbox"
}
]
}
} GET /mailاشتراكات بريدك mail:read الطلب نسخ curl -X GET https://syriana.store/api/v1/mail \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"id": 3,
"domain": "mybrand.com",
"mailboxes": 5
}
]
}
} POST /mailاطلب اشتراك بريد mail:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/mail \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"plan":"business","domain":"mybrand.com","seats":5}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 3,
"state": "provisioning"
}
} POST /mail/{id}/mailboxesأضف صندوقًا mail:write الطلب نسخ curl -X POST https://syriana.store/api/v1/mail/{id}/mailboxes \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"local":"info"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"address": "info@mybrand.com"
}
} POST /mail/{id}/loginرابط دخول البريد على الويب mail:write الطلب نسخ curl -X POST https://syriana.store/api/v1/mail/{id}/login \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"url": "https://…/one-time"
}
} POST /mail/{id}/renewجدّد الاشتراك mail:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/mail/{id}/renew \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 3
}
} 8 نقاط أضف دومينًا إلى الحماية وأدِر سجلّاته وإعداداته.
GET /cloud/zonesنطاقاتك المحمية cloud:read الطلب نسخ curl -X GET https://syriana.store/api/v1/cloud/zones \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"name": "mybrand.com",
"status": "active"
}
]
}
} POST /cloud/zonesأضف دومينًا للحماية cloud:write الطلب نسخ curl -X POST https://syriana.store/api/v1/cloud/zones \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"name":"mybrand.com"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"name": "mybrand.com",
"status": "pending"
}
} GET /cloud/zones/{name}/dnsسجلّات DNS في Cloudflare cloud:read الطلب نسخ curl -X GET https://syriana.store/api/v1/cloud/zones/{name}/dns \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"records": [
{
"type": "A",
"name": "@",
"proxied": true
}
]
}
} POST /cloud/zones/{name}/dnsأضف سجلًّا أو حدّثه cloud:write الطلب نسخ curl -X POST https://syriana.store/api/v1/cloud/zones/{name}/dns \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"type":"CNAME","name":"www","value":"mybrand.com"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /cloud/zones/{name}/dns/deleteاحذف سجلًّا cloud:write الطلب نسخ curl -X POST https://syriana.store/api/v1/cloud/zones/{name}/dns/delete \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"id":"rec_••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /cloud/zones/{name}/settingsغيّر إعدادًا (مثل وضع SSL) cloud:write الطلب نسخ curl -X POST https://syriana.store/api/v1/cloud/zones/{name}/settings \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"ssl":"full"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /cloud/zones/{name}/purgeامسح الكاش cloud:write الطلب نسخ curl -X POST https://syriana.store/api/v1/cloud/zones/{name}/purge \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"everything":true}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true
}
} POST /cloud/zones/{name}/checkافحص خوادم الأسماء الآن cloud:write الطلب نسخ curl -X POST https://syriana.store/api/v1/cloud/zones/{name}/check \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"status": "active"
}
} 5 نقاط اقرأ الرصيد والحركات، وافتح شحنة.
GET /balanceالرصيد والشروط balance:read الطلب نسخ curl -X GET https://syriana.store/api/v1/balance \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"balance": "120.00",
"currency": "USD"
}
} GET /balance/entriesدفتر الحركات balance:read الطلب نسخ curl -X GET https://syriana.store/api/v1/balance/entries \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"type": "order",
"amount": "-26.95"
}
]
}
} GET /balance/topup-methodsوسائل الشحن المتاحة لك balance:read الطلب نسخ curl -X GET https://syriana.store/api/v1/balance/topup-methods \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
"card",
"bank_transfer"
]
}
} POST /balance/topupافتح شحنة واحصل على رابط دفعها balance:write الطلب نسخ curl -X POST https://syriana.store/api/v1/balance/topup \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"amount":"50.00"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"url": "https://…/pay",
"topup_id": "TP-••••"
}
} GET /balance/topupsشحناتك وحالتها balance:read الطلب نسخ curl -X GET https://syriana.store/api/v1/balance/topups \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"topup_id": "TP-••••",
"state": "paid"
}
]
}
} 8 نقاط اقبض من عملائك على حسابك أنت عند مزوّد الدفع: أنشئ رابطًا، تابع الدفعات، وأرجع دفعة. المال يصل إلى حساب التاجر نفسه لا إلى حسابنا.
POST /payment_linksأنشئ رابط دفع (مرة واحدة أو متكرر) payments:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/payment_links \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"title":"اشتراك شهري","amount":25,"currency":"USD","mode":"once","reference":"ORD-77"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 41,
"url": "https://pay.example/p/••••",
"status": "open"
}
} GET /payment_linksروابطك وحالتها payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/payment_links \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"id": 41,
"title": "اشتراك شهري",
"status": "open"
}
]
}
} GET /payment_links/{id}رابط واحد مع مدفوعاته payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/payment_links/{id} \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 41,
"paid": 1
}
} POST /payment_links/{id}/disableأوقف رابطًا قائمًا payments:write الطلب نسخ curl -X POST https://syriana.store/api/v1/payment_links/{id}/disable \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 41,
"status": "disabled"
}
} GET /paymentsقائمة المدفوعات payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/payments \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"reference": "PAY-••••",
"amount": "25.00",
"status": "paid"
}
]
}
} GET /payments/summaryملخّص الدفعات والرسوم payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/payments/summary \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"paid": 12,
"total": "300.00",
"currency": "USD"
}
} GET /payments/{reference}دفعة واحدة payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/payments/{reference} \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"reference": "PAY-••••",
"status": "paid"
}
} POST /payments/{reference}/refundأرجع دفعة كاملة أو جزءًا منها (صلاحية ماليّة نمنحها بعد المراجعة) payments:refund يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/payments/{reference}/refund \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"amount":10}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"reference": "PAY-••••",
"status": "partially_refunded"
}
} 8 نقاط اربط حسابك عند مزوّد الدفع، وخصّص صفحة الدفع بشعارك ولونك ونطاقك (pay.متجرك.com).
GET /pay_accounts/providersالمزوّدون المتاحون لك payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/pay_accounts/providers \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"code": "provider_a"
}
]
}
} GET /pay_accountsحساباتك عند المزوّدين payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/pay_accounts \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"id": 3,
"provider": "provider_a",
"env": "test",
"active": false
}
]
}
} POST /pay_accountsأضف حسابك عند مزوّد (مفاتيحه تُحفظ مشفّرة ولا تُعاد إليك) payments:write الطلب نسخ curl -X POST https://syriana.store/api/v1/pay_accounts \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"providerCode":"provider_a","publicKey":"pk_••••","secretKey":"sk_••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 3,
"active": false
}
} POST /pay_accounts/{id}/activateفعّل الحساب بعد فحصه payments:write الطلب نسخ curl -X POST https://syriana.store/api/v1/pay_accounts/{id}/activate \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 3,
"active": true
}
} GET /pay_pageإعدادات صفحة الدفع الحالية payments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/pay_page \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"color": "#0F3D5C",
"domain": null
}
} POST /pay_pageالشعار واللون والسطر السفلي branding:write الطلب نسخ curl -X POST https://syriana.store/api/v1/pay_page \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"color":"#0F3D5C","footer":"شكرًا لثقتكم"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"saved": true
}
} POST /pay_page/domainsاربط نطاقك بصفحة الدفع branding:write الطلب نسخ curl -X POST https://syriana.store/api/v1/pay_page/domains \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"domain":"pay.example.com"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 8,
"status": "pending_dns"
}
} POST /pay_page/domains/{id}/checkافحص ربط النطاق branding:write الطلب نسخ curl -X POST https://syriana.store/api/v1/pay_page/domains/{id}/check \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 8,
"status": "connected"
}
} 4 نقاط اعرض على عميلك التقسيط على حسابك أنت: لا فوائد ولا غرامات، ونحن لا نُقرض ولا نمسك مالًا. العميل يوثّق هويّته ويوقّع من رابط، وكل قسط رابط دفع إلى حسابك.
POST /installmentsأنشئ عرض تقسيط لعميلك (صلاحية ماليّة) installments:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/installments \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"customer":{"ref":"c-88","name":"Sara"},"cash_price":300,"down_payment":60,"count":6,"interval_months":1}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 12,
"state": "offered",
"sign_url": "https://…/sign"
}
} GET /installmentsعقودك وحالتها installments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/installments \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"id": 12,
"state": "active"
}
]
}
} GET /installments/{id}عقد واحد مع جدول الأقساط installments:read الطلب نسخ curl -X GET https://syriana.store/api/v1/installments/{id} \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 12,
"schedule": [
{
"due": "2026-12-01",
"status": "pending"
}
]
}
} POST /installments/{id}/cancelألغِ عرضًا لم يُوقَّع بعد installments:write الطلب نسخ curl -X POST https://syriana.store/api/v1/installments/{id}/cancel \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 12,
"state": "cancelled"
}
} 4 نقاط افحص مشتريًا قبل التسليم: نعيد لون الدرع (أخضر/أصفر/أحمر) ونقاطه وإشارات من شبكة التجّار. إشارات لا أحكام: لا أسماء ولا أرقام. باقة مجانية 50 فحصًا، ثم باقات من رصيد الحساب.
POST /risk/checkافحص رقمًا أو بريدًا عندك risk:read الطلب نسخ curl -X POST https://syriana.store/api/v1/risk/check \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"phone":"+9665••••••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"shield": {
"color": "yellow",
"score": 42
},
"signals": [
"complaint_recent"
]
}
} POST /risk/reportأبلغ عن واقعة حدثت لك بدليل (للتطبيق الحيّ فقط، تنتهي البلاغات بمدّة وتقبل الاعتراض) risk:write الطلب نسخ curl -X POST https://syriana.store/api/v1/risk/report \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"phone":"+9665••••••••","evidence":"…"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 5,
"status": "recorded"
}
} POST /risk/vouchاشهد لمشترٍ سليم (للتطبيق الحيّ فقط) risk:write الطلب نسخ curl -X POST https://syriana.store/api/v1/risk/vouch \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"phone":"+9665••••••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"id": 6,
"status": "recorded"
}
} POST /risk/verifyاطلب من المشتري توثيق هويّته عندنا لا عندك risk:write الطلب نسخ curl -X POST https://syriana.store/api/v1/risk/verify \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"phone":"+9665••••••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"link": "https://…/verify/••••"
}
} 5 نقاط أنت توثّق هويّتك مرة واحدة لحسابك، فتُفتح لك الصلاحيات الماليّة. من زوّدتهم بحسابات يوثّقون هويّاتهم عبر نقاط المراجعة.
GET /kycحالة توثيقك وما ينقصه أي مفتاح الطلب نسخ curl -X GET https://syriana.store/api/v1/kyc \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"state": "requested",
"missing": [
"id_front"
]
}
} POST /kycأرسل بيانات التوثيق (فرد أو شركة) أي مفتاح الطلب نسخ curl -X POST https://syriana.store/api/v1/kyc \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"subject":"individual","legalName":"…"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"state": "submitted"
}
} POST /kyc/documentsارفع مستندًا (صورة حتى 4 ميغابايت) أي مفتاح الطلب نسخ curl -X POST https://syriana.store/api/v1/kyc/documents \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"kind": "id_front",
"accepted": true
}
} GET /merchants/kycطلبات من زوّدتهم بحسابات (مقيّدة) merchants:kyc الطلب نسخ curl -X GET https://syriana.store/api/v1/merchants/kyc \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"items": [
{
"ref": "m_••••",
"state": "submitted"
}
]
}
} POST /merchants/kyc/{ref}/decideاعتمد أو ارفض طلبًا (مقيّدة) merchants:kyc الطلب نسخ curl -X POST https://syriana.store/api/v1/merchants/kyc/{ref}/decide \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"decision":"approve"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ref": "m_••••",
"state": "verified"
}
} 1 نقاط اقرأ ما نشرناه في السوق داخل تطبيقاتنا. النشر نفسه يتمّ بمراجعة منّا اليوم، وليس عبر الـAPI.
GET /market/listingsالعروض المنشورة وأسعارها في المنصّة market:read الطلب نسخ curl -X GET https://syriana.store/api/v1/market/listings?platform=salla \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"listings": [
{
"key": "chat-connect",
"kind": "app"
}
]
}
} 1 نقاط البيع بالرصيد وتسليم المفاتيح يمرّ عبر مجموعتي «الطلبات» و«التراخيص» أعلاه: POST /orders ثم GET /orders/{id}/licenses. هنا ما يخصّ التفعيل بعد الشراء.
POST /activation/cidاطلب رمز تأكيد الهاتف CID من رقم IID (يُخصم من الرصيد عند النجاح فقط) activation:cid يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/activation/cid \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"iid":"•••••-•••••"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"cid": "•••••-•••••",
"charged": "0.50"
}
} 4 نقاط اشترك لعميلك وأضف مستخدمين. يُخصم من رصيد الحساب ويخضع لسقوف الإنفاق.
GET /workspace/plansالخطط والأسعار workspace:read الطلب نسخ curl -X GET https://syriana.store/api/v1/workspace/plans \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"plans": [
{
"code": "starter",
"per_user_month": {
"12": "7.00"
}
}
]
}
} GET /workspaceاشتراكات حسابك workspace:read الطلب نسخ curl -X GET https://syriana.store/api/v1/workspace \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"subscriptions": [
{
"id": 2,
"domain": "example.com"
}
]
}
} POST /workspaceاطلب اشتراكًا workspace:write يحتاج ترويسة Idempotency-Key : أعد المفتاح نفسه عند إعادة المحاولة.
الطلب نسخ curl -X POST https://syriana.store/api/v1/workspace \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Idempotency-Key: ord-0001" \
-H "Content-Type: application/json" \
-d '{"domain":"example.com","plan":"starter","months":12,"users":3}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"subscription": {
"id": 2,
"state": "provisioning"
}
}
} POST /workspace/{id}/usersأضف مقاعد workspace:write الطلب نسخ curl -X POST https://syriana.store/api/v1/workspace/{id}/users \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"count":2}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"subscription": {
"id": 2,
"users": 5
}
}
} 3 نقاط نقاط تفتح حساب Chat Connect لمتجر وتتابع اشتراكه. تُمنح صلاحيتها لوصلات المنصّات (مثل سلة) لا للتطبيقات العامة. التطبيق وتسجيل الدخول على chat.syriana.software، والباقات والشراء والتسجيل على bot.syriana.software.
POST /chat/provisionافتح حساب محادثات لمتجر chat:connect الطلب نسخ curl -X POST https://syriana.store/api/v1/chat/provision \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" \
-H "Content-Type: application/json" \
-d '{"store_name":"متجر مثال","email":"owner@example.com"}' جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"ok": true,
"status": "created"
}
} POST /chat/loginرابط دخول التاجر إلى التطبيق chat:connect الطلب نسخ curl -X POST https://syriana.store/api/v1/chat/login \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"url": "https://chat.syriana.software/…"
}
} POST /chat/statusحالة اشتراك المتجر chat:connect الطلب نسخ curl -X POST https://syriana.store/api/v1/chat/status \
-H "X-Syriana-Key: sy_test_••••" \
-H "X-Syriana-Timestamp: $TS" \
-H "X-Syriana-Signature-Version: 2" \
-H "X-Syriana-Signature: $SIG" جرّب بيانات تجريبية الردّ (تجريبي) نسخ {
"data": {
"plan": "starter",
"active": true
}
}
5 ابنِ حلّك وبِعهانسخ القسم Markdown المطوّر عندنا يصير شريكًا: بالصلاحيات التي يُمنحها يبني حلًّا كاملًا على سيريانا، ويبيعه ومعه منتجات رقمية وتطبيقاتنا.
1 سجّل كمطوّر متاح اليوم حساب واحد ثم «تطبيق جديد». المفتاح التجريبي يعمل من اللحظة الأولى.
2 وثّق هويّتك متاح اليوم فرد أو شركة. بعد قبولها تُفتح الصلاحيات الماليّة: شراء التراخيص وقراءة مفاتيحها وشحن الرصيد.
3 اطلب صلاحياتك بمراجعة منّا يدويًا الصلاحيات الأخرى (الإرجاع، التقسيط، التوثيق) نمنحها بعد مراجعة تطبيقك ووصفه.
4 ابنِ في بيئة التجربة متاح اليوم كتالوج وأسعار حقيقية بلا خصم. اختبر الدفع والتقسيط والدرع ثم قدّم تطبيقك للمراجعة.
5 اعرضه في السوق مخطّط أنشئ عرضًا (تطبيق أو قالب أو تكامل أو خدمة أو منتج رقمي) بوصف وسعر لكل منصّة.
6 مراجعتنا بمراجعة منّا يدويًا نختبر العرض وصلاحياته. اليوم ينشره مدير النظام عندنا يدويًا.
7 بِع واقبض مخطّط نبيع نحن باسمنا ونسلّم، ونحوّل لك أرباحك بعد التسليم. النسبة وموعد الدفعات تنتظر قرار المالك.
ما الذي تعرضه تطبيق تثبّته المنصّة (مثل متجر سلة) أو يُشترى كإضافة داخل تطبيقنا.
متاح اليوم قالب قالب متجر أو موقع جاهز. في الكود اليوم نوعه «theme».
متاح اليوم تكامل ربط بين منصّتين (محاسبة، شحن، واتساب).
مخطّط خدمة عمل تنفّذه أنت: تصميم أو ربط أو تسويق. يظهر تحت اسم سيريانا.
متاح اليوم منتج رقمي ترخيص أو ملف أو بطاقة تسلَّم آليًا. إعادة بيع تراخيصنا موجودة اليوم؛ رفع مفاتيحك أنت مخطّط.
مخطّط الأسعار والعمولة والدفعات تضع أنت سعر عرضك لكل منصّة، والعملة مثل عملة المنصّة. عمولة سيريانا: من 10% إلى 25% بحسب شريحة مبيعاتك الشهرية (الجدول في صفحة الشركاء). موعد الدفعات وحدّها الأدنى: كل 14 يومًا للشريك الموثوق أو كل 30 يومًا لغيره. تسحب أرباحك من رصيد الحساب بطرق الاستلام التي تسجّلها. بوضوح: ما لا يوجد بعد نشر العروض في السوق اليوم يتمّ عندنا يدويًا بعد المراجعة، ولا يوجد نشر ذاتي ولا API للنشر. البائع لا يظهر اسمه للمشتري؛ يظهر العرض تحت اسم سيريانا. رفع مفاتيحك أنت لبيعها كمنتج رقمي غير متاح؛ المتاح إعادة بيع تراخيصنا.
6 Webhooks: نخبرك حين يحدث شيءانسخ القسم Markdown بدل أن تسأل كل دقيقة «هل اكتمل الطلب؟»، نرسل إلى خادمك رسالة حين يحدث الحدث.
الحدث متى order.fulfilledاكتمل الطلب وصدرت تراخيصه فعلًا. order.processingقُبل الطلب وخُصم، وبعض التراخيص قيد التجهيز. order.cancelledأُلغي الطلب وأُعيد المبلغ إلى رصيدك. license.deliveredوصل مفتاح كان طلبًا مسبقًا. balance.lowرصيد الحساب قارب النفاد. balance.topped_upوصلت شحنتك وأُضيفت إلى رصيدك. balance.settledصدرت فاتورة دورتك الآجلة. balance.plan_dueحان تجديد باقتك ورصيدك لا يكفي. quota.warningبلغت 80٪ من طلبات باقتك في هذه الدورة. payment.paidدفع عميلك رابط دفع لك. payment.failedفشلت محاولة دفع على رابطك. payment.cancelledألغى الدافع العملية. payment.refundedاستُرجعت الدفعة كاملة. payment.partially_refundedاستُرجع جزء من الدفعة. installment.signedوقّع عميلك عقد التقسيط. installment.completedسُدّد العقد كاملًا. verification.verifiedأثبت مشتريك هويّته عندنا. لا نرسل لك مستنداته. verification.refusedلم يجتَز مشتريك التوثيق. قرار البيع يبقى لك.
تحقّق من التوقيع قبل أن تثق الترويسات: X-Syriana-Topic · X-Syriana-Timestamp · X-Syriana-Signature · X-Syriana-Delivery . التوقيع هنا HMAC(secret, "{timestamp}.{raw_body}") ، وهو غير توقيع الطلبات.
curl JavaScript Python PHP
نسخ # التحقق يجري في خادمك، القاعدة واحدة في كل لغة:
# expected = hmac_sha256(webhook_secret, timestamp + "." + raw_body)
# قارنه بترويسة X-Syriana-Signature بمقارنة ثابتة الزمن. نسخ import crypto from "node:crypto";
export function verify(rawBody, ts, signature, secret) {
const expected = crypto.createHmac("sha256", secret).update(ts + "." + rawBody).digest("hex");
const a = Buffer.from(expected), b = Buffer.from(signature);
return a.length === b.length && crypto.timingSafeEqual(a, b);
} نسخ import hmac, hashlib
def verify(raw_body: bytes, ts: str, signature: str, secret: str) -> bool:
expected = hmac.new(secret.encode(), ts.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, signature) # never == نسخ <?php
function verify(string $raw, string $ts, string $sig, string $secret): bool {
return hash_equals(hash_hmac("sha256", $ts . "." . $raw, $secret), $sig);
} إن لم يردّ خادمك نعيد المحاولة 1 1 min 2 5 min 3 15 min 4 1 h 5 2 h 6 4 h بعد المحاولة السادسة نتوقّف وننبّهك في لوحتك. ردّ بـ 2xx بسرعة ثم عالج الرسالة لاحقًا.
أرسل رسالة تجريبية بيانات تجريبية الحدث order.fulfilled order.processing order.cancelled license.delivered balance.low balance.topped_up balance.settled balance.plan_due quota.warning payment.paid payment.failed payment.cancelled payment.refunded payment.partially_refunded installment.signed installment.completed verification.verified verification.refused أرسل
ما سيصل خادمك نسخ POST https://your-app.example/hooks/syriana
X-Syriana-Topic: order.fulfilled
X-Syriana-Timestamp: 1790000000
X-Syriana-Signature: 9f2c••••
X-Syriana-Delivery: 481
{
"id": "1042",
"topic": "order.fulfilled",
"data": { "order_id": "ORD-1042" }
}
7 MCP: اربط أي مساعد ذكي بحسابكانسخ القسم Markdown MCP طريقة موحّدة يتحدّث بها المساعد الذكي مع خدمة خارجية. عنوان واحد mcp.syriana.software (القرار معلّق) تضيفه في مساعدك، فيعمل في حسابك بأمان.
Claude (سطح المكتب والويب) Claude Code ChatGPT Cursor / VS Code
افتح الإعدادات ثم «Connectors» (الموصّلات). اختر «إضافة موصّل مخصّص» والصق العنوان https://mcp.syriana.software . اضغط «اتصال»، سجّل الدخول إلى حسابك ووافق على الصلاحيات. اسأله: «ما حالة دوميناتي؟» شغّل في الطرفية الأمر الظاهر أدناه. افتح /mcp داخل Claude Code واختر syriana ثم «Authenticate». وافق على الصلاحيات في المتصفح. نسخ claude mcp add --transport http syriana https://mcp.syriana.software افتح الإعدادات ثم «Connectors» وفعّل وضع المطوّر إن لزم. أضف موصّلًا بالعنوان https://mcp.syriana.software . سجّل الدخول ووافق على الصلاحيات. افتح ملف إعداد MCP (Cursor: .cursor/mcp.json ، VS Code: .vscode/mcp.json ). ألصق التعريف الظاهر أدناه واحفظ. عند أول استعمال تظهر نافذة الموافقة. نسخ {
"mcpServers": {
"syriana": { "url": "https://mcp.syriana.software" }
}
} mcp.syriana.software/oauth/authorize
Claude يطلب الوصول إلى حسابك في سيريانا تنتظر تأكيدك لن يستطيع: الاسترجاع، سحب المال، أو تغيير بيانات الهوية.
وافق ارفض
شكل توضيحي لشاشة الموافقة. تراها وتلغيها لاحقًا من «حسابي ← التطبيقات المتصلة». أربع درجات أمان أ يقرأ بحرّية قراءة فقط: الحالة والأسعار والفواتير. لا يغيّر شيئًا.
ب يجهّز مسوّدة وأنت تؤكّد كل ما يصرف من رصيد حسابك يمرّ بتأكيدك أنت، لا بقرار المساعد.
ج تغييرات قابلة للتراجع بلا مال مثل تعديل سجلّ DNS. لا أدوات منها اليوم؛ تُضاف لاحقًا [يؤكّده المالك].
د لا يفعله المساعد أبدًا الاسترجاع وسحب المال وتوثيق الهوية. تُحجب حتى لو طلبتها الصلاحيات.
الأدوات المتاحة للمساعد الكل أ · قراءة ب · مسوّدة
أدوات الدرجتين ج ود: لا توجد اليوم، والدرجة د محجوبة دائمًا. أدوات الشراء تظهر فقط لحساب له رصيد مسبق الدفع، ولا تُمنح صلاحيتها إلا باتصال OAuth لا بمفتاح يدوي.
حدود الاستعمال لكل باقة حدود نداءات MCP لكل باقة تظهر في لوحة المطوّر.. أداة contact_support لها حدّ يومي. حدّ API العام 120 طلبًا في الدقيقة.
سجلّ التدقيق كل نداء من مساعدك يُسجَّل باسم التطبيق والأداة والوقت، وتراه وتلغي الربط بضغطة من «حسابي ← التطبيقات المتصلة». تنتهي صلاحية الاتصال تلقائيًا ويُجدَّد.
8 مهارات جاهزة للذكاء الاصطناعيانسخ القسم Markdown المساعد الذكي يقرأ هذه الملفات قبل أن يعمل، فيعرف كيف نعمل وما الذي يجب أن يسألك عنه. لذلك يخطئ أقل وينفّذ ما تقصده فعلًا.
لماذا يهمّ هذا؟ المهارة ملف SKILL.md يشرح مهمة واحدة خطوة بخطوة، مثل «اشترِ دومينًا واربطه».بدونها يخمّن المساعد المسارات والترتيب، وقد يشتري قبل أن يسألك.معها يتبع الترتيب الصحيح ويسألك قبل أي صرف من رصيد حسابك.
اشترِ دومينًا واربطه جاهزة للمعاينة يعلّم المساعد أن يتحقّق من توفّر الاسم، ويعرض السعر، ويسألك قبل الشراء، ثم يضبط سجلّات DNS.
GET /domains/check · POST /domains · POST /domains/{name}/dns
معاينة SKILL.md syriana-domain-connect/SKILL.md نسخ ---
name: syriana-domain-connect
description: Use when the user wants to buy a domain from Syriana and point it at a site or mailbox.
---
# Buy and connect a domain
1. Call `GET /domains/check?name=` and show the price. Never buy before the user says yes.
2. Buy with `POST /domains` and a fresh `Idempotency-Key`. The money comes from the user's account balance (رصيد الحساب).
3. Add DNS records with `POST /domains/{name}/dns`. Read records back to confirm.
## Never
- Do not guess nameservers or auth codes.
- Do not retry a purchase with a new key; reuse the old one. نزّل الحزمة انسخ SKILL.md
جهّز بريد الأعمال على الدومين جاهزة للمعاينة يعلّم المساعد إنشاء الاشتراك والصناديق وضبط MX وSPF وDKIM وDMARC بالترتيب الصحيح.
POST /mail · POST /mail/{id}/mailboxes · POST /domains/{name}/dns
معاينة SKILL.md syriana-business-email-dns/SKILL.md نسخ ---
name: syriana-business-email-dns
description: Use when the user wants business e-mail (info@theirdomain) set up and delivering.
---
# Set up business e-mail
1. Confirm the domain is in the account (`GET /domains`).
2. Order with `POST /mail` (Idempotency-Key required) after the user confirms seats and price.
3. Add mailboxes, then the MX, SPF, DKIM and DMARC records the order response lists.
4. Ask the user to send a test mail before saying "done". نزّل الحزمة انسخ SKILL.md
أطلق موقع ووردبريس جاهزة للمعاينة من اختيار الباقة إلى الدومين وشهادة SSL ورابط الدخول إلى لوحة الموقع.
GET /hosting/plans · POST /hosting · POST /hosting/{id}/login
معاينة SKILL.md syriana-wordpress-launch/SKILL.md نسخ ---
name: syriana-wordpress-launch
description: Use when the user wants a WordPress site live on Syriana hosting.
---
# Launch a WordPress site
1. List plans with `GET /hosting/plans`; recommend the smallest that fits.
2. Order with `POST /hosting` after the user confirms the price.
3. Poll `GET /hosting` until `state` is `active`.
4. Give the user the one-time link from `POST /hosting/{id}/login`; never store it. نزّل الحزمة انسخ SKILL.md
أدِر خادم VPS قريبًا يعلّم المساعد الاتصال بخادمك وفحصه ومتى يطلب موافقتك قبل إعادة تشغيله.
يعتمد على نقاط نهاية VPS غير متاحة بعد
معاينة SKILL.md syriana-vps-manage/SKILL.md نسخ ---
name: syriana-vps-manage
description: Use when the user asks about their Syriana VPS: status, restart, rebuild.
---
# Manage a VPS (planned)
This pack waits for the VPS endpoints. Until then it only teaches the assistant to point the user to the dashboard. نزّل الحزمة انسخ SKILL.md
بِع خدمات سيريانا داخل تطبيقك جاهزة للمعاينة للتجّار والمطوّرين: الكتالوج والطلبات والتسليم وإشعارات Webhooks خطوة بخطوة.
GET /products · POST /orders · GET /orders/{id}/licenses · webhooks
معاينة SKILL.md syriana-sell-in-your-app/SKILL.md نسخ ---
name: syriana-sell-in-your-app
description: Use when the user is building a store or app that resells Syriana products.
---
# Sell Syriana services in an app
1. Read prices with `GET /products` (merchant price, not retail).
2. Create orders with `POST /orders` and an `Idempotency-Key` per customer purchase.
3. Deliver on the `order.fulfilled` webhook, then read keys from `/orders/{id}/licenses`.
4. Verify every webhook signature before trusting it. نزّل الحزمة انسخ SKILL.md
بيانات تجريبية أزرار التنزيل أمثلة شكلية. تُوضع الحزمة في مجلد المهارات عند Claude Code أو أي مساعد يدعم تنسيق Agent Skills.
وثائق يقرؤها الذكاء الاصطناعي /llms.txtفهرس مختصر يقرأه الذكاء الاصطناعي أولًا: ما هي سيريانا وأين كل صفحة.
انسخ العنوان /llms-full.txtكل التوثيق في ملف نصي واحد، ليضعه المساعد في ذاكرته دفعة واحدة.
انسخ العنوان /openapi.jsonوصف OpenAPI 3.1 لكل نقاط النهاية، يستورده Postman وأدوات الذكاء.
انسخ العنوان العنوان النهائي لهذه الملفات يُعلن عند الإطلاق.
مقتطف AGENTS.md لمستودعك ضعه في جذر مشروعك ليتبع أي مساعد برمجة قواعدنا.
AGENTS.md نسخ # Syriana
This repo calls the Syriana API (https://syriana.store/api/v1).
- Read /llms.txt before writing integration code.
- Sign every request with HMAC v2; see the syriana-sell-in-your-app skill.
- Send an Idempotency-Key on every POST that spends money.
- Never put sy_live_ keys in the repo. Use env vars SY_KEY and SY_SECRET.
- Ask the user before any purchase, renewal or deletion. انسخ أي صفحة كـMarkdown كل قسم في هذه الصفحة فيه زر «انسخ القسم Markdown» في رأسه، لتلصقه في محادثتك مع المساعد.
10 الأسئلةهل أحتاج أن أدفع لأجرّب؟ لا. المفتاح التجريبي مجاني ولا يخصم من رصيد حسابك.
هل يشتري المساعد الذكي بدلًا مني؟ لا. يجهّز الشراء وأنت تؤكّد، والاسترجاع وسحب المال والهوية محجوبة عنه.
كيف ألغي مفتاحًا أو ربطًا؟ من لوحة التحكم ← ربط الذكاء، بضغطة.
ماذا لو ضاع السرّ؟ أنشئ مفتاحًا جديدًا وألغِ القديم. لا نستطيع إظهار السرّ مرة ثانية.
للمطوّرين