واجهة الشركاء

For travel agencies who want to offer شركة آرك للعمرة Umrah groups from their own systems.

لوكالات السفر

اربط أنظمتكم بمجموعات العمرة لدينا

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

ماذا يستطيع الشريك أن يفعل

واجهة مخصصة للوكالات، وفق أسلوب عملكم الحالي مع مجموعاتنا.

توفر المجموعات مباشرة

اطلعوا على مجموعات العمرة المفتوحة وعدد المقاعد المتبقية كما هي الآن.

الأسعار والفنادق والرحلات

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

أنشئوا حجوزات معلّقة

أنشئوا حجزاً يُوقف لحساب وكالتكم حتى يؤكده فريقنا.

تابعوا حجوزاتكم

راجعوا الحجوزات المنشأة في حساب وكالتكم وتابعوا حالتها.

كيف يعمل

من أول طلب حتى تأكيد الحجز، تبقى العملية لدى فريقنا.

  1. 01

    اطلبوا الصلاحية

    أرسلوا استفساراً موجزاً ببيانات وكالتكم عبر النموذج في هذه الصفحة أو البريد أو واتساب.

  2. 02

    نصدر مفتاحكم

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

  3. 03

    اربطوا أنظمتكم

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

  4. 04

    نؤكد الحجوزات

    تُنشأ الحجوزات معلّقة. يؤكدها فريقنا بالطريقة المعتادة قبل المضي فيها.

صُممت بعناية لبياناتكم

يصدر فريقنا صلاحية الوصول، وتكون مقيدة بوكالتكم، وتنتقل عبر اتصال آمن.

HTTPS فقط

الواجهة متاحة فقط عبر اتصال HTTPS مشفّر.

مفاتيح لكل وكالة

تحصل كل وكالة معتمدة على بياناتها الخاصة. يجب إرسال المفاتيح في ترويسات الطلب لا في عنوان الصفحة.

بياناتكم فقط

ترى الوكالة وتحجز على حسابها فقط، دون حجوزات الشركاء الآخرين أو بياناتهم.

حدود المعدل

تحدّ القيود من الطلبات حتى يبقى الخدمة موثوقاً لكل شريك.

نظرة على نقاط الاتصال

خريطة موجزة للخدمة. التفاصيل الكاملة للطلبات والردود في الوثائق الحية.

الطريقةالمسارالغرضالوصول
GET/api/umrah/pingحالة الخدمةمفتوح
GET/api/umrah/docsوثائق للقراءةمفتوح
GET/api/umrah/openapi.jsonوصف الواجهة للقراءة الآليةمفتوح
GET/api/umrah/public/packagesباقات العمرة المنشورة على هذا الموقع (دون مفتاح)مفتوح
GET/api/umrah/public/packages/{packageCode}باقة منشورة واحدة حسب الرمز (دون مفتاح)مفتوح
GET/api/umrah/groupsالمجموعات المتاحة والتوفر والأسعار والفنادق والرحلاتمفتاح الوكالة
GET/api/umrah/room-typesقائمة أنواع الغرفمفتاح الوكالة
GET/api/umrah/gendersقائمة الجنسمفتاح الوكالة
GET/api/umrah/reservationsعرض حجوزات وكالتكممفتاح الوكالة
GET/api/umrah/reservations/{no}الاطلاع على حجز واحدمفتاح الوكالة
POST/api/umrah/reservationsإنشاء حجز معلّقمفتاح الوكالة

واجهة الباقات العامة — متاحة للجميع

يمكن لأي شخص الاطلاع على باقات العمرة نفسها المعروضة على هذا الموقع. لا يلزم مفتاح واجهة أو تسجيل دخول.

تعرض التغذية العامة رموز الباقات والعناوين وتواريخ السفر وأسماء الفنادق والرحلات والأسعار العلنية كما تظهر على هذا الموقع.

الحجز ما زال يتطلب مفتاح شريك. واجهة الباقات العامة للقراءة فقط.

مثال على الطلب

GET /api/umrah/public/packages
curl -sS /api/umrah/public/packages

مثال على الرد

{
  "packages": [
    {
      "packageCode": "UP-100001",
      "groupCode": "UG-100001",
      "title": "7 Nights Makkah & Madinah",
      "summary": "Direct flights with 4-star hotels.",
      "pageUrl": "https://crm.archsoftware.net.pk/umrah-packages/7-nights-makkah-madinah",
      "travelDate": "2026-12-01",
      "returnDate": "2026-12-08",
      "makkahNights": 4,
      "madinahNights": 3,
      "nights": 7,
      "currency": "SAR",
      "priceFrom": 4500,
      "pricesVisible": true,
      "prices": [
        { "code": "sharing", "label": "Sharing", "amount": 4500 },
        { "code": "quad", "label": "Quad room", "amount": 4800 },
        { "code": "triple", "label": "Triple room", "amount": 5200 },
        { "code": "double", "label": "Double room", "amount": 5800 }
      ],
      "availability": "available",
      "availableSeats": 18,
      "totalSeats": 45,
      "airline": { "name": "Saudia", "code": "SV" },
      "route": "LHE-JED",
      "departure": { "flightNo": "SV123", "from": "LHE", "to": "JED", "date": "2026-12-01", "etd": "10:00", "eta": "13:30", "baggage": "30kg" },
      "returnFlight": { "flightNo": "SV124", "from": "MED", "to": "LHE", "date": "2026-12-08", "etd": "15:00", "eta": "22:00", "baggage": "30kg" },
      "includes": { "visa": true, "transport": "AC Bus" },
      "terms": "Prices are per person and subject to availability.",
      "hotels": [
        { "city": "Makkah", "name": "Example Makkah Hotel", "stars": 4, "rating": "4 Star", "distance": "400 m to Haram" },
        { "city": "Madinah", "name": "Example Madinah Hotel", "stars": 4, "rating": "4 Star", "distance": "300 m to Haram" }
      ]
    }
  ]
}

مثال JavaScript

fetch("/api/umrah/public/packages")
  .then(function (r) { return r.json(); })
  .then(function (data) { console.log(data.packages); });

اطلب صلاحية الواجهة

أخبرونا عن وكالتكم. يراجع فريقنا الطلب ويصدر بيانات الواجهة عند الموافقة.