GDS API بتاعنا هو واجهة واحدة مبنية على الأوامر وبتتكلم جاليليو (Travelport) وأماديوس في نفس الوقت. أصدر تذاكر، وأدر PNRs، وأتمت سير عمل السفر — من نفس الـ endpoint.
نظرة عامة على GDS API
الـGDS API بتاع GDSHub بيوفر واجهة مبنية على الأوامر لأكبر نظامين للتوزيع العالمي — جاليليو (Travelport) وأماديوس. بيتعامل مع توافر الرحلات وسجلات أسماء الركاب (PNRs) وطرق الدفع وإصدار التذاكر وإعادة الإصدار. كل طلب POST، وكل رد JSON.
مع الـGDS API بتاعنا، بتبعت نفس نوع الأمر اللي كنت هتكتبه على ترمنال GDS حي — الـGDS API بيوجّهه للنظام الصح على أساس صيغة الأمر. علشان تحصل على مفتاح API الشخصي بتاعك، سجّل دخول على حسابك وولّد بيانات الاعتماد من لوحة التحكم.
المصادقة على GDS API
كل طلب للـGDS API لازم يحتوي على إيميلك المسجّل ومفتاح الـ API.
| الباラميتر | الوصف | مطلوب |
|---|---|---|
email | عنوان إيميلك المسجّل | أيوه |
api_key | مفتاح GDS API الشخصي بتاعك (بتولّده من لوحة التحكم) | أيوه |
action | لازم يكون execute_command | أيوه |
command | أمر GDS بصيغة جاليليو أو أماديوس (مثلاً an26MAYSHJCAI لأماديوس، A26MAYSHJCAI لجاليليو) | أيوه |
request_count بيتزود أوتوماتيك لكل طلب ناجح للـ GDS API. راقب استخدامك من لوحة تحكم حسابك.
الـ Endpoint بتاع GDS API
كل طلبات الـGDS API لازم تتبعت عبر POST مع Content-Type: application/x-www-form-urlencoded أو application/json.
مقارنة الأوامر — أماديوس مقابل جاليليو في GDS API
تحت فيه مرجع جنب لجنب لأهم أوامر الحجز في النظامين. الـGDS API بيقبل الصيغتين — بيكتشف بنفسه أنهي صيغة انت بتبعتها.
| الغرض | أماديوس (1A) | جاليليو (1G) |
|---|---|---|
| ابحث عن رحلات (الشارقة → القاهرة، 26 مايو) | AN26MAYSHJCAI | A26MAYSHJCAI |
| بيع كرسي واحد في فئة Y على القطاع 1 | SS1Y1 | 01Y1 |
| إضافة اسم الراكب | NM1MOUSSA/MAHMOUD | N.MOUSSA/MAHMOUD |
| بيانات اتصال الوكالة / PTA الافتراضي | AP | P.T* |
| اتفاقية الإصدار | TKOK | T.T* |
| Received from (الوكيل / مرجع العميل) | RFM | R.M |
| إنهاء وحفظ العملية | ER | ER |
| تسعير الإيتينيراري | FXP | FQ |
صيغة رد 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.
أدوات ومراجع لمطوري GDS API
موارد GDSHub دي مفيدة جنب الـGDS API — للتحقق من الأكواد وفك الضرايب وفهم منطق الأسعار: