پلتفرم
یک API
چیست
«یک API» مدل اتصال traveldistro است: یک طرح احراز هویت، یک قالب درخواست و یک کاتالوگ خطا در تمام حوزههای سفر. یک بار متصل میشوید و هر حوزه جدید یک endpoint تازه است، نه یک پروژه تازه.
قابلیتها
یک قالب درخواست
هر پاسخ با همان ساختار data و meta برمیگردد و برای ردیابی request id دارد.
یک کاتالوگ خطا
همان کدهای خطای ماشینخوان در بلیت، ترانسفر، خودرو، eSIM و بقیه.
حوزهها به شکل endpoint
افزودن یک حوزه یعنی صدا زدن یک مسیر جدید با همان اعتبارنامهای که دارید.
GET /v1/account
Authorization: TD-HMAC-SHA256 KeyId=key_29xk, Signature=9f41…
X-TD-Timestamp: 1785603201
X-TD-Nonce: 5b1e-8c02
{
"data": { "name": "Acme Travel", "status": "active" },
"meta": { "request_id": "req_01JG7X…", "locale": "en" }
}پرسشهای پرتکرار
- برای هر حوزه کلید جدا لازم است؟
- نه. یک کلید API و یک طرح امضا همه حوزههای قرارداد شما را پوشش میدهد.
- وقتی حوزه جدیدی راه بیفتد چه میشود؟
- به شکل endpointهای جدید زیر همان قرارداد ظاهر میشوند. احراز هویت و کیف پول شما تغییر نمیکند.
صفحات مرتبط
- کیف پول و صورتحسابیک موجودی پیشپرداخت، چندارزی
- پایاییکاتالوگ خطا، idempotency، آپتایم
- امنیتامضای HMAC، مدیریت کلید، فهرست مجاز IP
آماده اتصال هستید؟
حجم و محصولات مورد نظر خود را بگویید. کلیدهای سندباکس را برایتان آماده میکنیم.