GDS API مجاني: توثيق جاليليو وأماديوس للمطورين

توثيق GDS API مجاني لتكامل أوامر جاليليو وأماديوس

GDS API بتاعنا هو واجهة واحدة مبنية على الأوامر وبتتكلم جاليليو (Travelport) وأماديوس في نفس الوقت. أصدر تذاكر، وأدر PNRs، وأتمت سير عمل السفر — من نفس الـ endpoint.

الإصدار 1.0 — جاهز للإنتاج يدعم جاليليو 1G وأماديوس 1A ✔ مجاني بالكامل للاستخدام

نظرة عامة على GDS API

الـGDS API بتاع GDSHub بيوفر واجهة مبنية على الأوامر لأكبر نظامين للتوزيع العالمي — جاليليو (Travelport) وأماديوس. بيتعامل مع توافر الرحلات وسجلات أسماء الركاب (PNRs) وطرق الدفع وإصدار التذاكر وإعادة الإصدار. كل طلب POST، وكل رد JSON.

مع الـGDS API بتاعنا، بتبعت نفس نوع الأمر اللي كنت هتكتبه على ترمنال GDS حي — الـGDS API بيوجّهه للنظام الصح على أساس صيغة الأمر. علشان تحصل على مفتاح API الشخصي بتاعك، سجّل دخول على حسابك وولّد بيانات الاعتماد من لوحة التحكم.

🆓 GDS API مجاني: الـGDS API بتاع GDSHub متقدم من غير أي تكلفة — مفيش رسوم مخفية، ولا اشتراكات، واستخدام سخي للتطوير والإنتاج. إحنا مؤمنين إن لازم ندّي المطورين ومحترفي السفر وصول مفتوح لبيانات GDS.

المصادقة على GDS API

كل طلب للـGDS API لازم يحتوي على إيميلك المسجّل ومفتاح الـ API.

الباラميترالوصفمطلوب
emailعنوان إيميلك المسجّلأيوه
api_keyمفتاح GDS API الشخصي بتاعك (بتولّده من لوحة التحكم)أيوه
actionلازم يكون execute_commandأيوه
commandأمر GDS بصيغة جاليليو أو أماديوس (مثلاً an26MAYSHJCAI لأماديوس، A26MAYSHJCAI لجاليليو)أيوه
ملاحظة: الـrequest_count بيتزود أوتوماتيك لكل طلب ناجح للـ GDS API. راقب استخدامك من لوحة تحكم حسابك.

الـ Endpoint بتاع GDS API

POST https://gdshub.pro/account/api/v1/1t/1t

كل طلبات الـGDS API لازم تتبعت عبر POST مع Content-Type: application/x-www-form-urlencoded أو application/json.

مقارنة الأوامر — أماديوس مقابل جاليليو في GDS API

تحت فيه مرجع جنب لجنب لأهم أوامر الحجز في النظامين. الـGDS API بيقبل الصيغتين — بيكتشف بنفسه أنهي صيغة انت بتبعتها.

الغرضأماديوس (1A)جاليليو (1G)
ابحث عن رحلات (الشارقة → القاهرة، 26 مايو)AN26MAYSHJCAIA26MAYSHJCAI
بيع كرسي واحد في فئة Y على القطاع 1SS1Y101Y1
إضافة اسم الراكبNM1MOUSSA/MAHMOUDN.MOUSSA/MAHMOUD
بيانات اتصال الوكالة / PTA الافتراضيAPP.T*
اتفاقية الإصدارTKOKT.T*
Received from (الوكيل / مرجع العميل)RFMR.M
إنهاء وحفظ العمليةERER
تسعير الإيتينيراريFXPFQ
نصيحة: الـترتيب مهم. في النظامين، بتبحث → تبيع → تضيف الاسم → تضيف بيانات الاتصال → اتفاقية الإصدار → Received From → إنهاء العملية (ER) → سعّر → دفع → أصدر. إنهاء العملية قبل التسعير هو اللي بيحفظ الـ PNR في النظام.

صيغة رد GDS API

رد النجاح النموذجي من الـGDS API بيحتوي على success وoutput (نتيجة الأمر) وبيانات session (الـ PNR الحالي والقطاعات… إلخ).

✅ إصدار تذكرة ناجح:
{
  "success": true,
  "output": "TICKET ISSUED SUCCESSFULLY\nPNR: 32JBQP\nPASSENGERS: 1 | SEGMENTS: 1\nTOTAL AMOUNT: AED 2,340.00\nBASE FARE: AED 1,650.00\nTAX: AED 690.00\n\nTICKET NUMBERS:\nPAX 1: 869-7041540806",
  "session": []
}
❌ رد خطأ (طريقة الدفع ناقصة):
{
  "success": true,
  "output": "CANNOT ISSUE TICKET - MISSING ELEMENTS:\n• NO VALID PAYMENT METHOD SET\n\nMissing:\nNAMES, PAYMENT METHOD, AP, PRICE, TICKETING",
  "session": []
}

أمثلة كود GDS API

أمثلة جاهزة للتشغيل بأشهر لغات البرمجة للـGDS API. بدّل الإيميل ومفتاح الـ API بحاجة بتاعتك. خانة الـcommand بتقبل صيغة أماديوس أو جاليليو.

curl -X POST https://gdshub.pro/account/api/v1/1t/1t \
  -d "[email protected]" \
  -d "api_key=YOUR_API_KEY" \
  -d "action=execute_command" \
  -d "command=an26MAYSHJCAI"
<?php
$data = [
    'email'    => '[email protected]',
    'api_key'  => 'YOUR_API_KEY',
    'action'   => 'execute_command',
    'command'  => 'FXP'    // تسعير أماديوس. استخدم 'FQ' لجاليليو.
];

$ch = curl_init('https://gdshub.pro/account/api/v1/1t/1t');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
import requests

url = "https://gdshub.pro/account/api/v1/1t/1t"
payload = {
    "email": "[email protected]",
    "api_key": "YOUR_API_KEY",
    "action": "execute_command",
    "command": "TTP"     # إصدار تذكرة أماديوس. مكافئ جاليليو: "T.T*"
}

response = requests.post(url, data=payload)
print(response.json())
const axios = require('axios');

const params = new URLSearchParams();
params.append('email', '[email protected]');
params.append('api_key', 'YOUR_API_KEY');
params.append('action', 'execute_command');
params.append('command', 'an26MAYSHJCAI');   // أو جاليليو: 'A26MAYSHJCAI'

axios.post('https://gdshub.pro/account/api/v1/1t/1t', params)
  .then(res => console.log(res.data))
  .catch(err => console.error(err));
#!/bin/bash
EMAIL="[email protected]"
API_KEY="YOUR_API_KEY"
COMMAND="SS1Y1"    # بيع كرسي أماديوس. جاليليو: "01Y1"

curl -X POST https://gdshub.pro/account/api/v1/1t/1t \
  -d "email=$EMAIL" \
  -d "api_key=$API_KEY" \
  -d "action=execute_command" \
  -d "command=$COMMAND"
require 'net/http'
require 'uri'

uri = URI('https://gdshub.pro/account/api/v1/1t/1t')
params = {
  email: '[email protected]',
  api_key: 'YOUR_API_KEY',
  action: 'execute_command',
  command: 'ER'      # نفس الأمر في أماديوس وجاليليو
}

response = Net::HTTP.post_form(uri, params)
puts response.body
package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    data := url.Values{}
    data.Set("email", "[email protected]")
    data.Set("api_key", "YOUR_API_KEY")
    data.Set("action", "execute_command")
    data.Set("command", "FXP")  // تسعير أماديوس. جاليليو: "FQ"

    resp, _ := http.PostForm("https://gdshub.pro/account/api/v1/1t/1t", data)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

نصايح وأفضل الممارسات للـ GDS API

  • استمرارية الجلسة: الـGDS API بيحتفظ بجلسة لكل إيميل — تقدر تشغّل سلسلة من الأوامر (بحث → إضافة اسم → دفع → إصدار) من غير ما تفقد السياق.
  • تسلسل الأوامر: ممكن تتبعت كذا أمر في طلب واحد للـ GDS API بفصلهم بفاصلة منقوطة. مثال أماديوس: command=NM1AHMED;SS1Y1;FPCASH;TTP. مثال جاليليو: command=N.AHMED;01Y1;F.S;T.T*.
  • معالجة الأخطاء: دايماً راجع خانة الـsuccess في رد الـ GDS API. خانة الـoutput فيها رسايل مقروءة من الـ GDS.
  • حدود الاستخدام (Rate Limiting): الـrequest_count بتاعك بيتم تتبعه؛ لو محتاج حدود أعلى، تواصل مع الدعم.
  • الخلط بين الأنظمة: ما تخلطش صيغة أماديوس وجاليليو في نفس جلسة الـ GDS API — اختار واحد وامشي عليه. سياق الجلسة مربوط بالـ GDS اللي خدم أول أمر.
  • مثال كامل من الأول للآخر: لسير عمل Python كامل بيغطي البحث عن الرحلات والتسعير وإنشاء الطلب ومعالجة الـ PNR، اقرا دليلنا عن أتمتة الإصدار باستخدام أماديوس API.