الربط البرمجي مع ويب كرت

محتوى نشاطك في ويب كرت — الخدمات والمنتجات والمدونة والفريق والتقييمات وساعات العمل — متاح لأي موقع آخر تملكه. وما يحدث في ذلك الموقع — الحجوزات والطلبات والرسائل والتقييمات — يصل إلى لوحتك كأنه جاء من صفحتك تمامًا. لا حاجة لبناء لوحة تحكم أو قاعدة بيانات: تحدّث المحتوى من ويب كرت، ويتحدّث موقعك معه.

العنوان الأساسي https://webkrt.com/api/site/v1
أنشئ مفتاحًا OpenAPI 3 (Postman / Swagger)

ابدأ في 3 خطوات

  1. من لوحتك افتح الإعدادات ← الربط البرمجي (API) وأنشئ مفتاحًا. سمِّه باسم الموقع الذي سيستخدمه، واختر له الصلاحيات التي يحتاجها فقط. المفتاح يظهر مرة واحدة — انسخه حينها.
  2. أرسله مع كل طلب في الترويسة Authorization بالشكل Bearer wk_…. احفظه على خادمك في متغيّر بيئة — لا تضعه في مستودع عام.
  3. اطلب ما تريد عرضه. مثال: صفحة «خدماتنا» في موقعك:
JavaScript (Node / Next.js)
const API = "https://webkrt.com/api/site/v1";
const res = await fetch(API + "/services?per_page=50", {
  headers: { Authorization: "Bearer " + process.env.WEBKRT_KEY },
});
const { data } = await res.json();

for (const s of data) {
  console.log(s.name, s.price, s.image_url);
}

وكذلك لكل شيء آخر: المنتجات لمتجرك، المقالات لمدونتك، الفريق لصفحة «من نحن»، والمواعيد المتاحة لنموذج الحجز. وحين يرسل زائر نموذجًا في موقعك، أرسله إلى نقطة الكتابة المناسبة فيصل إلى لوحتك مع إشعار.

المفاتيح والمصادقة

كل طلب يحتاج مفتاحًا، عدا هذا التوثيق وopenapi.json. أرسله بإحدى الطريقتين:

Authorization: Bearer wk_ab12cd34ef56_••••••••••••••••••••••••••••••••
X-Api-Key: wk_ab12cd34ef56_••••••••••••••••••••••••••••••••
  • المفتاح تابع لنشاط واحد: يقرأ ويكتب بيانات ذلك النشاط فقط — لا يوجد رقم نشاط تمرّره.
  • أنشئ مفاتيح بعدد مواقعك أو مشاريعك (حتى 25 مفتاحًا فعّالًا). مفتاح لكل موقع يعني أن تسرّب أحدها لا يمسّ الباقي.
  • تسرّب مفتاح؟ من اللوحة: «تجديد» يصدر سرًّا جديدًا ويوقف القديم فورًا (بنفس الاسم والصلاحيات والسجل)، و«إلغاء» يوقف المفتاح نهائيًا.
  • ويب كرت تحفظ بصمة السرّ فقط — لا أحد، ولا نحن، يستطيع عرض المفتاح بعد إنشائه.

الصلاحيات

كل مفتاح يحمل صلاحيات تختارها. طلب خارج صلاحيات المفتاح يُرفض بالرمز scope_missing.

الصلاحيةما تسمح به
content:readقراءة المحتوى — الملف التعريفي، الخدمات، المنتجات، المدونة، المعرض، الفريق، التقييمات، الساعات والمواعيد المتاحة.
bookings:writeإرسال الحجوزات — طلبات حجز تصل إلى المواعيد في لوحتك.
orders:writeإرسال الطلبات وتتبّعها — طلبات متجر بأسعار تُحسب على الخادم، ومتابعة حالتها.
inquiries:writeإرسال رسائل التواصل — رسائل تصل إلى صندوق الاستفسارات.
reviews:writeنشر التقييمات — تقييمات تُنشر على صفحتك.

شكل الردود

كل ردّ JSON بشكل واحد. النجاح:

{
    "ok": true,
    "data": [
        "…"
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 42,
        "pages": 3
    }
}
  • القوائم مقسّمة لصفحات: ?page=2&per_page=50 (حتى 100)، وmeta يخبرك بالمجموع.
  • اللغة: ?lang=ar أو ?lang=en (أو الترويسة Accept-Language؛ وإلا فلغة نشاطك الافتراضية). النص يصل بثلاثة أشكال — باللغة المطلوبة مع الرجوع للأخرى إن كانت فارغة، والاثنتان كما هما:
{
    "name": "تنظيف البشرة",
    "name_ar": "تنظيف البشرة",
    "name_en": "Facial cleansing"
}
  • الصور والروابط عناوين كاملة، جاهزة لـ <img src>.
  • content_html (الخدمات والمقالات) HTML منسّق نظّفته ويب كرت مسبقًا — يمكنك وضعه في صفحتك. أي حقل نصي آخر هو نص عادي: عامله كأي نص (escape).
  • المبالغ أرقام بالدينار الأردني (currency: "JOD"). مجاميع الطلبات تحسبها ويب كرت دائمًا.
  • الأوقات بصيغة ISO 8601 مع فرق التوقيت (2026-10-25T13:05:00+03:00). أرسل وقت الحجز بصيغة YYYY-MM-DD HH:MM بتوقيت النشاط المحلي.
  • قد تكون الحقول null إن لم تعبّئها — صمّم موقعك على ذلك. قد تُضاف حقول جديدة ضمن v1؛ لا يُحذف حقل ولا يتغيّر اسمه.

الأخطاء

عند الرفض: رمز ثابت تبني عليه منطقك (code)، وجملة لمطوّرك (message)، وفي أخطاء البيانات رسالة لكل حقل (fields) — جاهزة للعرض بجانب الحقل في نموذجك.

{
    "ok": false,
    "error": {
        "code": "validation_failed",
        "message": "يرجى تعبئة الحقول المطلوبة.",
        "fields": {
            "phone": "يرجى تعبئة الحقول المطلوبة."
        }
    }
}
codeHTTPالمعنى
missing_key401لم يُرسل مفتاح API.
invalid_key401المفتاح غير صحيح.
key_revoked401أُلغي هذا المفتاح من لوحة التحكم.
key_expired401انتهت صلاحية المفتاح.
scope_missing403المفتاح لا يملك الصلاحية لهذا الطلب.
origin_not_allowed403هذا الموقع غير مسموح له باستخدام المفتاح من المتصفح.
subscription_inactive403اشتراك النشاط غير فعّال حاليًا.
not_found404غير موجود.
method_not_allowed405الطريقة غير مدعومة لهذا المسار.
slot_taken409الوقت المطلوب محجوز.
invalid_json400جسم الطلب ليس JSON صالحًا.
validation_failed422بيانات ناقصة أو غير صحيحة — التفاصيل في fields.
rate_limited429طلبات كثيرة — انتظر الثواني في Retry-After.
server_error500خطأ غير متوقّع.

الحدود والأمان

  • 1,000 طلب كل 10 دقائق لكل مفتاح. كل ردّ يحمل X-RateLimit-Limit وX-RateLimit-Remaining؛ وعند التجاوز يصلك 429 مع Retry-After (بالثواني).
  • الحجوزات والطلبات والرسائل والتقييمات تخضع أيضًا لحدود مكافحة الإزعاج نفسها التي تحمي صفحتك، لكل نشاط.
  • خزّن ما تقرؤه مؤقتًا: المحتوى يتغيّر حين تعدّله، لا كل ثانية. القراءات تصل مع Cache-Control: private, max-age=60؛ والتخزين لبضع دقائق على خادمك يبقي موقعك سريعًا وضمن الحدّ بارتياح.
  • من المتصفح مباشرة؟ الأفضل أن تطلب من خادمك. وإن لزم أن يطلب JavaScript صفحتك مباشرة، فاستخدم مفتاحًا بصلاحية content:read فقط، وأضف موقعك في «المواقع المسموحة» (مثل https://www.example.com، أو https://*.example.com لكل النطاقات الفرعية): عندها يُرفض أي متصفح على موقع آخر. الخوادم لا ترسل Origin فلا تتأثّر بالقائمة.
  • إن انتهى اشتراك النشاط، يجيب كل طلب بـ subscription_inactive حتى يُجدَّد.
نقاط الكتابة (الحجوزات والطلبات والرسائل والتقييمات) تنشئ سجلات حقيقية في لوحتك — ومنها زر «جرّبه» في هذه الصفحة.

النشاط

ملف النشاط

GET/business content:read

الاسم والوصف والشعار والغلاف ووسائل التواصل والعنوان والعملة والضريبة وملخّص التقييمات — كل ما يلزم لرأس موقعك وتذييله.

curl "https://webkrt.com/api/site/v1/business" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 26,
        "slug": "nour-clinic",
        "type": "عيادة",
        "type_ar": "عيادة",
        "type_en": "Clinic",
        "name": "عيادة نور",
        "name_ar": "عيادة نور",
        "name_en": "Nour Clinic",
        "description": "عيادة جلدية وتجميل في عمّان.",
        "description_ar": "عيادة جلدية وتجميل في عمّان.",
        "description_en": "A dermatology and cosmetic clinic in Amman.",
        "bio": "نهتمّ ببشرتك منذ 2012",
        "bio_ar": "نهتمّ ببشرتك منذ 2012",
        "bio_en": "Caring for your skin since 2012",
        "logo_url": "https://webkrt.com/uploads/logos/nour.png",
        "cover_url": "https://webkrt.com/uploads/covers/cover-1.jpg",
        "accent_color": "#0f766e",
        "phone": "+962 79 123 4567",
        "whatsapp": "https://wa.me/962791234567",
        "email": "hello@nour.example",
        "website": "https://nour.example",
        "address": "شارع المدينة المنورة",
        "city": "عمّان",
        "country": "الأردن",
        "map_url": "https://maps.app.goo.gl/xyz",
        "card_url": "https://webkrt.com/B/nour-clinic",
        "default_language": "ar",
        "languages": [
            "ar",
            "en"
        ],
        "currency": "JOD",
        "tax": {
            "enabled": true,
            "rate": 16.0,
            "prices_include_tax": true
        },
        "reviews": {
            "count": 128,
            "average": 4.8
        }
    }
}

ساعات العمل

GET/hours content:read

أيام الأسبوع بدءًا من الأحد، مع وقت الفتح والإغلاق بصيغة 24 ساعة، أو مغلق.

curl "https://webkrt.com/api/site/v1/hours" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "open_now": true,
        "days": [
            {
                "day": 6,
                "day_name": "السبت",
                "day_name_en": "Saturday",
                "closed": false,
                "opens": "10:00",
                "closes": "14:00"
            },
            {
                "day": 0,
                "day_name": "الأحد",
                "day_name_en": "Sunday",
                "closed": false,
                "opens": "09:00",
                "closes": "18:00"
            },
            {
                "day": 1,
                "day_name": "الاثنين",
                "day_name_en": "Monday",
                "closed": false,
                "opens": "09:00",
                "closes": "18:00"
            },
            {
                "day": 2,
                "day_name": "الثلاثاء",
                "day_name_en": "Tuesday",
                "closed": false,
                "opens": "09:00",
                "closes": "18:00"
            },
            {
                "day": 3,
                "day_name": "الأربعاء",
                "day_name_en": "Wednesday",
                "closed": false,
                "opens": "09:00",
                "closes": "18:00"
            },
            {
                "day": 4,
                "day_name": "الخميس",
                "day_name_en": "Thursday",
                "closed": false,
                "opens": "09:00",
                "closes": "16:00"
            },
            {
                "day": 5,
                "day_name": "الجمعة",
                "day_name_en": "Friday",
                "closed": true,
                "opens": null,
                "closes": null
            }
        ]
    }
}

الخدمات والمنتجات

الخدمات

GET/services content:read

خدماتك مع السعر والمدة والتصنيف والقسم. الخدمة «قابلة للحجز» إذا كان لها سعر أو مدة.

المعاملات

category_id
integer · query
خدمات تصنيف واحد فقط.
department_id
integer · query
خدمات قسم واحد فقط.
q
string · query
بحث في الاسم والوصف.
page
integer · query
رقم الصفحة (يبدأ من 1).
per_page
integer · query
عدد العناصر في الصفحة (حتى 100، الافتراضي 20).
curl "https://webkrt.com/api/site/v1/services?category_id=3" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 12,
            "name": "تنظيف البشرة",
            "name_ar": "تنظيف البشرة",
            "name_en": "Facial cleansing",
            "summary": "تنظيف عميق للمسام",
            "summary_ar": "تنظيف عميق للمسام",
            "summary_en": "Deep pore cleansing",
            "image_url": "https://webkrt.com/uploads/services/s-12.jpg",
            "price": 25.0,
            "duration_minutes": 45,
            "bookable": true,
            "category": {
                "id": 3,
                "name": "التجميل",
                "name_ar": "التجميل",
                "name_en": "Cosmetic"
            },
            "department": {
                "id": 2,
                "name": "الجلدية",
                "name_ar": "الجلدية",
                "name_en": "Dermatology"
            }
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 14,
        "pages": 1
    }
}

خدمة واحدة

GET/services/{id} content:read

الخدمة كاملة، ومعها المحتوى المنسّق (HTML) بالعربية والإنجليزية.

المعاملات

idمطلوب
integer · path
رقم الخدمة.
curl "https://webkrt.com/api/site/v1/services/12" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 12,
        "name": "تنظيف البشرة",
        "name_ar": "تنظيف البشرة",
        "name_en": "Facial cleansing",
        "summary": "تنظيف عميق للمسام",
        "summary_ar": "تنظيف عميق للمسام",
        "summary_en": "Deep pore cleansing",
        "image_url": "https://webkrt.com/uploads/services/s-12.jpg",
        "price": 25.0,
        "duration_minutes": 45,
        "bookable": true,
        "category": {
            "id": 3,
            "name": "التجميل",
            "name_ar": "التجميل",
            "name_en": "Cosmetic"
        },
        "department": {
            "id": 2,
            "name": "الجلدية",
            "name_ar": "الجلدية",
            "name_en": "Dermatology"
        },
        "content_html": "<p>جلسة مدتها 45 دقيقة…</p>",
        "content_html_ar": "<p>جلسة مدتها 45 دقيقة…</p>",
        "content_html_en": "<p>A 45-minute session…</p>"
    }
}

تصنيفات الخدمات

GET/service-categories content:read

بالترتيب الذي اخترته في لوحتك، مع عدد الخدمات في كل تصنيف.

curl "https://webkrt.com/api/site/v1/service-categories" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 3,
            "name": "التجميل",
            "name_ar": "التجميل",
            "name_en": "Cosmetic",
            "sort": 1,
            "services_count": 6
        }
    ]
}

الأقسام

GET/departments content:read

أقسام نشاطك (تخصّصات العيادة، أقسام الشركة…) مع عدد الخدمات المرتبطة بكل قسم.

curl "https://webkrt.com/api/site/v1/departments" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 2,
            "name": "الجلدية",
            "name_ar": "الجلدية",
            "name_en": "Dermatology",
            "services_count": 4
        }
    ]
}

المنتجات

GET/products content:read

منتجات متجرك مع السعر والتوفّر والتصنيف. الأسعار للعرض فقط — الطلب يُسعَّر دائمًا على الخادم.

المعاملات

category_id
integer · query
منتجات تصنيف واحد فقط.
in_stock
boolean · query
true للمتوفّر فقط.
q
string · query
بحث في الاسم والوصف.
page
integer · query
رقم الصفحة (يبدأ من 1).
per_page
integer · query
عدد العناصر في الصفحة (حتى 100، الافتراضي 20).
curl "https://webkrt.com/api/site/v1/products?category_id=4" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 31,
            "name": "كريم مرطّب",
            "name_ar": "كريم مرطّب",
            "name_en": "Moisturising cream",
            "price": 12.5,
            "in_stock": true,
            "image_url": "https://webkrt.com/uploads/products/p-31.jpg",
            "category": {
                "id": 4,
                "name": "العناية بالبشرة",
                "name_ar": "العناية بالبشرة",
                "name_en": "Skin care"
            }
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 42,
        "pages": 3
    }
}

منتج واحد

GET/products/{id} content:read

المنتج كاملًا مع وصفه.

المعاملات

idمطلوب
integer · path
رقم المنتج.
curl "https://webkrt.com/api/site/v1/products/31" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 31,
        "name": "كريم مرطّب",
        "name_ar": "كريم مرطّب",
        "name_en": "Moisturising cream",
        "price": 12.5,
        "in_stock": true,
        "image_url": "https://webkrt.com/uploads/products/p-31.jpg",
        "category": {
            "id": 4,
            "name": "العناية بالبشرة",
            "name_ar": "العناية بالبشرة",
            "name_en": "Skin care"
        },
        "description": "للبشرة الجافة، 50 مل.",
        "description_ar": "للبشرة الجافة، 50 مل.",
        "description_en": "For dry skin, 50 ml."
    }
}

تصنيفات المنتجات

GET/product-categories content:read

تصنيفات متجرك.

curl "https://webkrt.com/api/site/v1/product-categories" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 4,
            "name": "العناية بالبشرة",
            "name_ar": "العناية بالبشرة",
            "name_en": "Skin care"
        }
    ]
}

المحتوى

المدونة

GET/blog content:read

مقالاتك من الأحدث، مع مقتطف قصير لكل مقال.

المعاملات

q
string · query
بحث في الاسم والوصف.
page
integer · query
رقم الصفحة (يبدأ من 1).
per_page
integer · query
عدد العناصر في الصفحة (حتى 100، الافتراضي 20).
curl "https://webkrt.com/api/site/v1/blog" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 7,
            "title": "خمس عادات لبشرة صحية",
            "title_ar": "خمس عادات لبشرة صحية",
            "title_en": "Five habits for healthy skin",
            "excerpt": "شرب الماء، الواقي الشمسي، النوم الكافي…",
            "image_url": "https://webkrt.com/uploads/blog/b-7.jpg",
            "published_at": "2026-10-12T09:00:00+03:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 9,
        "pages": 1
    }
}

مقال واحد

GET/blog/{id} content:read

المقال كاملًا بالمحتوى المنسّق (HTML).

المعاملات

idمطلوب
integer · path
رقم المقال.
curl "https://webkrt.com/api/site/v1/blog/7" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 7,
        "title": "خمس عادات لبشرة صحية",
        "title_ar": "خمس عادات لبشرة صحية",
        "title_en": "Five habits for healthy skin",
        "excerpt": "شرب الماء، الواقي الشمسي، النوم الكافي…",
        "image_url": "https://webkrt.com/uploads/blog/b-7.jpg",
        "published_at": "2026-10-12T09:00:00+03:00",
        "content_html": "<p>شرب الماء، الواقي الشمسي، النوم الكافي…</p>",
        "content_html_ar": "<p>شرب الماء، الواقي الشمسي، النوم الكافي…</p>",
        "content_html_en": "<p>Drinking water, sunscreen, enough sleep…</p>"
    }
}

الشهادات والاعتمادات

GET/certificates content:read

شهاداتك واعتماداتك من الأحدث.

curl "https://webkrt.com/api/site/v1/certificates" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "title": "البورد الأردني في الجلدية",
            "source": "المجلس الطبي الأردني",
            "details": null,
            "year": 2019
        }
    ]
}

العلامات التجارية

GET/brands content:read

العلامات التي تبيعها مع عدد منتجات كل منها.

curl "https://webkrt.com/api/site/v1/brands" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 5,
            "name": "La Roche-Posay",
            "logo_url": "https://webkrt.com/uploads/brands/lrp.png",
            "products_count": 12
        }
    ]
}

الفريق

GET/team content:read

الأطباء أو المختصّون الظاهرون للعامة — لاستخدام رقم أحدهم عند الحجز معه.

curl "https://webkrt.com/api/site/v1/team" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 3,
            "name": "د. ليلى حداد",
            "specialty": "جلدية وتجميل",
            "color": "#0ea5e9"
        }
    ]
}

التقييمات

GET/reviews content:read

ملخّص التقييمات وأحدثها.

المعاملات

limit
integer · query
عدد التقييمات (حتى 50، الافتراضي 20).
curl "https://webkrt.com/api/site/v1/reviews?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "summary": {
            "count": 128,
            "average": 4.8
        },
        "items": [
            {
                "name": "سارة",
                "rating": 5,
                "comment": "خدمة ممتازة",
                "created_at": "2026-10-20T18:30:00+03:00"
            }
        ]
    }
}

الحجوزات

المواعيد المتاحة

GET/availability content:read

أوقات يوم واحد حسب ساعات العمل وجداول الأطباء، وما حُجز منها. إن لم يكن الجدول مُعدًّا في لوحتك فالقائمة فارغة وscheduling = false (يُقبل أي وقت).

المعاملات

dateمطلوب
YYYY-MM-DD · query
اليوم بصيغة YYYY-MM-DD.
practitioner_id
integer · query
جدول طبيب/مختصّ واحد.
service_id
integer · query
لمعرفة مدة الخدمة.
curl "https://webkrt.com/api/site/v1/availability?date=2026-11-02&practitioner_id=3" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "date": "2026-11-02",
        "scheduling": true,
        "slot_minutes": 30,
        "block_taken": true,
        "slots": [
            {
                "time": "09:00",
                "available": true
            },
            {
                "time": "09:30",
                "available": false
            },
            {
                "time": "10:00",
                "available": true
            }
        ]
    }
}

حقول النماذج

GET/form-fields content:read

إعدادات نماذجك كما ضبطتها في لوحتك (إجباري/اختياري/مخفي، التسميات، الطول الأقصى) — ليطابق نموذج موقعك نموذج صفحتك تمامًا.

المعاملات

form
string · query
contact أو booking أو review (بدونها: الثلاثة).
curl "https://webkrt.com/api/site/v1/form-fields?form=booking" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "booking": {
            "service_id": {
                "visible": true,
                "required": false,
                "label": "الخدمة",
                "label_ar": null,
                "label_en": null,
                "max_length": null,
                "input_language": "auto"
            },
            "name": {
                "visible": true,
                "required": true,
                "label": "الاسم",
                "label_ar": null,
                "label_en": null,
                "max_length": 150,
                "input_language": "auto"
            },
            "phone": {
                "visible": true,
                "required": true,
                "label": "رقم الجوال",
                "label_ar": "جوالك",
                "label_en": "Mobile",
                "max_length": 20,
                "input_language": "en"
            }
        }
    }
}

إرسال طلب حجز

POST/bookings bookings:write

يصل الطلب إلى «المواعيد» في لوحتك بحالة «جديد» مع إشعار. تُطبَّق إعدادات نموذج الحجز، ويُرفض وقت محجوز إن طلبت ذلك (409).

جسم الطلب (JSON)

name
string
اسم صاحب الحجز (إجباري حسب إعدادك).
phone
string
رقم الهاتف.
date_time
YYYY-MM-DD HH:MM
الوقت المطلوب: YYYY-MM-DD HH:MM.
service_id
integer
الخدمة المطلوبة.
practitioner_id
integer
الطبيب/المختصّ المطلوب.
note
string
تفاصيل إضافية.

يقبل أيضًا نموذج HTML عاديًا (application/x-www-form-urlencoded) بنفس الأسماء.

curl -X POST "https://webkrt.com/api/site/v1/bookings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"سارة أحمد","phone":"0791234567","date_time":"2026-11-02 10:30","service_id":12,"practitioner_id":3,"note":"أول زيارة"}'
201 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 4812
    }
}

المتجر والطلبات

مناطق التوصيل

GET/delivery-zones content:read

المناطق المفعّلة مع رسوم كل منها والحدّ الأدنى للطلب.

curl "https://webkrt.com/api/site/v1/delivery-zones" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": [
        {
            "id": 2,
            "name": "خلدا",
            "name_ar": "خلدا",
            "name_en": "Khalda",
            "fee": 1.5,
            "min_order": 10.0,
            "eta_minutes": 45
        }
    ]
}

إنشاء طلب

POST/orders orders:write

يُسعَّر الطلب على الخادم من أسعار منتجاتك (لا تُرسل أسعارًا)، ويُخصم من المخزون، ويظهر في «الطلبات» مع إشعار. احتفظ بـ uuid لمتابعة الحالة.

جسم الطلب (JSON)

itemsمطلوب
array
الأصناف، كل صنف: {"product_id": 31, "quantity": 2, "options": [5]} (الخيارات اختيارية).
nameمطلوب
string
اسم العميل.
phone
string
الهاتف (أو البريد — واحد منهما على الأقل).
email
string
البريد الإلكتروني.
fulfilment
string
pickup (الافتراضي) أو delivery.
zone_id
integer
منطقة التوصيل (للتوصيل).
address
string
العنوان (للتوصيل).
notes
string
ملاحظات على الطلب.

يقبل أيضًا نموذج HTML عاديًا (application/x-www-form-urlencoded) بنفس الأسماء.

curl -X POST "https://webkrt.com/api/site/v1/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"product_id":31,"quantity":2}],"name":"عمر خليل","phone":"0791234567","email":"omar@example.com","fulfilment":"delivery","zone_id":2,"address":"عمّان — خلدا","notes":"بدون بصل"}'
201 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 5521,
        "uuid": "0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f",
        "status": "new",
        "fulfilment": "delivery",
        "items": [
            {
                "product_id": 31,
                "name": "كريم مرطّب",
                "name_ar": "كريم مرطّب",
                "name_en": "Moisturising cream",
                "quantity": 2,
                "unit_price": 12.5,
                "total": 25.0
            }
        ],
        "subtotal": 25.0,
        "delivery_fee": 1.5,
        "tax": 3.66,
        "total": 26.5,
        "currency": "JOD",
        "created_at": "2026-10-25T13:05:00+03:00",
        "tracking_url": "https://webkrt.com/Track/0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f"
    }
}

حالة طلب

GET/orders/{uuid} orders:write

طلب واحد بالمعرّف uuid الذي رجع عند إنشائه — الحالة والأصناف والمبالغ ورابط التتبّع.

المعاملات

uuidمطلوب
string · path
معرّف الطلب الذي رجع عند إنشائه.
curl "https://webkrt.com/api/site/v1/orders/0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 5521,
        "uuid": "0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f",
        "status": "new",
        "fulfilment": "delivery",
        "items": [
            {
                "product_id": 31,
                "name": "كريم مرطّب",
                "name_ar": "كريم مرطّب",
                "name_en": "Moisturising cream",
                "quantity": 2,
                "unit_price": 12.5,
                "total": 25.0
            }
        ],
        "subtotal": 25.0,
        "delivery_fee": 1.5,
        "tax": 3.66,
        "total": 26.5,
        "currency": "JOD",
        "created_at": "2026-10-25T13:05:00+03:00",
        "tracking_url": "https://webkrt.com/Track/0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f"
    }
}

الرسائل والتقييمات

إرسال رسالة تواصل

POST/inquiries inquiries:write

تصل إلى «الاستفسارات» في لوحتك مع إشعار. تُطبَّق إعدادات نموذج التواصل.

جسم الطلب (JSON)

nameمطلوب
string
اسم المرسل.
phone
string
الهاتف.
email
string
البريد الإلكتروني.
subject
string
الموضوع.
message
string
نص الرسالة (إجباري حسب إعدادك).

يقبل أيضًا نموذج HTML عاديًا (application/x-www-form-urlencoded) بنفس الأسماء.

curl -X POST "https://webkrt.com/api/site/v1/inquiries" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"ليلى","phone":"0791234567","email":"laila@example.com","subject":"استفسار عن الأسعار","message":"هل تعملون يوم الجمعة؟"}'
201 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 4812
    }
}

نشر تقييم

POST/reviews reviews:write

يُنشر التقييم على صفحتك فورًا كما في تقييمات بطاقتك.

جسم الطلب (JSON)

ratingمطلوب
integer
من 1 إلى 5.
nameمطلوب
string
اسم المقيِّم.
comment
string
التعليق.

يقبل أيضًا نموذج HTML عاديًا (application/x-www-form-urlencoded) بنفس الأسماء.

curl -X POST "https://webkrt.com/api/site/v1/reviews" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rating":5,"name":"سارة","comment":"خدمة ممتازة"}'
201 · مثال الرد
{
    "ok": true,
    "data": {
        "id": 4812
    }
}