Орталар, шектеулер және нұсқалау

Sandbox пен production, бір негізгі URL

Негізгі URL: https://api.dubaitrip.com/v1. Sandbox пен production оны ортақ пайдаланады; ортаны сіз қол қоятын кілт таңдайды. dt_sbx_ кілті жеткізушілеріміздің тест орталарында жұмыс істейді — іздеулер, бағалау, тариф тексерулері, тапсырыстар, брондаулар, билет рәсімдеу және күшін жою тест қорында басынан аяғына дейін жұмыс істейді, нақты билетсіз не ваучерсіз және ешқандай ақы алынбайды. Production тексеруінен кейін берілетін dt_live_ кілті нақты қорға жетеді және депозитіңізден есептеледі.

Sandbox және production брондаулары әзірлеуші порталыңызда бөлек сақталады (әр брондау белгіленеді), ал scope-тар, шектеулер мен IP ережелері әр орта үшін бөлек басқарылады.

Сұрау лимиттері мен квоталар

Әр кілт token bucket (секундына тұрақты сұраулар саны плюс шың көлемі) және күнделікті квота арқылы шектеледі. Sandbox әдепкі мәндері: секундына 2 сұрау, шың көлемі 5, күніне 2000 сұрау. Production шектеулері әр тіркелгі үшін келісіледі. Bucket асып кетсе, Retry-After тақырыбымен 429 api_rate_limited жауабы қайтарылады; квота таусылса, UTC түн ортасына дейін 429 api_quota_exceeded жауабы қайтарылады.

Ауыр іздеулер әдейі асинхронды: бірден searchId алып, іздеу эндпоинтін сұрап отыру үшін wait=false, ал толық нәтижені бір шақыруда алу үшін wait=true жіберіңіз. Сұрап отыру (polling) кез келген басқа сұрау сияқты лимиттеріңізге есептеледі.

Қарау/брондау шектеуі

Іздеулер сонымен қатар сіз жасайтын брондауларға қатысты шектеледі. Жылжымалы кезеңнің (әдепкі бойынша 7 күн) әр күні тегін іздеу лимитін береді, ал сол кезеңде жасалған әр брондау үстіне тағы cap іздеу қосады — cap дегеніміз тіркелгіңіз үшін келісілген және әзірлеуші порталында көрсетілетін бір брондауға келетін іздеулер саны. Сұрап отыру, бағалау, тариф ережелері және мазмұнды оқу ешқашан есептелмейді; тек рейс пен қонақүй іздеу шақырулары есептеледі.

Лимит таусылғанда іздеулер келесі UTC түн ортасын — кезеңнің ең ескі күні шығып қалатын сәтті — көрсететін Retry-After тақырыбымен 429 look_to_book_exceeded жауабын қайтарады. Брондау лимитті бірден қайта ашады. Әзірлеуші порталындағы Қарау/брондау картасы нақты уақыттағы есептегіштерді, cap мәнін және қалған санды көрсетеді; егер интеграцияңыз заңды түрде брондағаннан әлдеқайда көп іздесе, бас тартуға қарамастан қайталай бермей, бізден cap мәнін арттыруды сұраңыз.

Идемпотенттілік

Ақша немесе қор міндеттемесін жасайтын эндпоинттер — тапсырыс не брондау жасау, рәсімдеу, күшін жою — Idempotency-Key тақырыбын талап етеді (128 таңбаға дейінгі кез келген бірегей жол, UUID ең қолайлысы). Сол кілтпен қайталау көшірме жасаудың орнына бастапқы жауапты қайтарады; қайта пайдаланылған кілтпен басқа дене жіберілсе, 409 жауабы қайтарылады.

Нұсқалау

Нұсқа жолда көрсетіледі (/v1). Қосымша өзгерістер — жаңа міндетті емес өрістер, жаңа enum мәндері, жаңа эндпоинттер — нұсқаны арттырмай шығарылады, сондықтан деректерді абайлап талдап, белгісіз өрістерді елемеңіз. Үйлесімділікті бұзатын өзгерістер көшу кезеңімен жаңа негізгі нұсқа алады; Өзгерістер журналы нұсқаулығында әрбір өзгеріс тізімделген.