Mazingira, vikomo na matoleo

Sandbox na uzalishaji, URL moja ya msingi

URL ya msingi: https://api.dubaitrip.com/v1. Sandbox na uzalishaji huitumia pamoja; ufunguo unaotumia kutia sahihi ndio unaochagua mazingira. Ufunguo wa dt_sbx_ hufanya kazi dhidi ya mazingira ya majaribio ya wasambazaji wetu — utafutaji, upangaji bei, ukaguzi wa bei, oda, uhifadhi, utoaji tiketi na kughairi vyote hufanya kazi mwanzo hadi mwisho kwenye huduma za majaribio, bila tiketi au vocha halisi na bila malipo yoyote. Ufunguo wa dt_live_, unaotolewa baada ya ukaguzi wa uzalishaji, hufikia huduma halisi na hulipwa kutoka kwenye amana yako.

Uhifadhi wa sandbox na wa uzalishaji hutenganishwa kwenye lango lako la wasanidi programu (kila uhifadhi una alama), na wigo, vikomo na kanuni za IP husimamiwa kwa kila mazingira.

Vikomo vya kasi na migao

Kila ufunguo hudhibitiwa na ndoo ya tokeni (maombi endelevu kwa sekunde pamoja na mlipuko) na mgao wa kila siku. Chaguo-msingi za sandbox: maombi 2/sekunde, mlipuko 5, maombi 2,000/siku. Vikomo vya uzalishaji hukubaliwa kwa kila akaunti. Kuzidi ndoo hujibu 429 api_rate_limited pamoja na kichwa cha Retry-After; kumaliza mgao hujibu 429 api_quota_exceeded hadi saa sita usiku UTC.

Utafutaji mzito hauendi sambamba kwa makusudi: tuma wait=false upate searchId mara moja na uulize endpoint ya utafutaji mara kwa mara, au wait=true upokee matokeo kamili kwa mwito mmoja. Kuuliza mara kwa mara huhesabiwa katika vikomo vyako kama ombi jingine lolote.

Udhibiti wa utafutaji dhidi ya uhifadhi

Utafutaji pia hugawiwa kulingana na uhifadhi unaofanya. Kila siku ya kipindi kinachosogea (siku 7 kwa chaguo-msingi) hutoa kiwango cha bure cha utafutaji, na kila uhifadhi unaofanywa ndani ya kipindi hicho huongeza utafutaji mwingine wa cap juu yake — cap ni idadi ya utafutaji kwa kila uhifadhi iliyokubaliwa kwa akaunti yako na inayoonyeshwa kwenye lango la wasanidi programu. Kuuliza mara kwa mara, upangaji bei, kanuni za nauli na usomaji wa maudhui havihesabiwi kamwe; ni miito ya utafutaji wa ndege na hoteli pekee inayohesabiwa.

Kiwango kikishatumika, utafutaji hujibu 429 look_to_book_exceeded pamoja na kichwa cha Retry-After kinachoelekeza saa sita usiku UTC inayofuata, siku ya zamani zaidi ya kipindi inapoondoka. Uhifadhi hufungua kiwango tena mara moja. Kadi ya Utafutaji dhidi ya uhifadhi kwenye lango la wasanidi programu inaonyesha vihesabu vya moja kwa moja, kikomo na kilichobaki; ikiwa muunganisho wako kihalali hutafuta zaidi sana kuliko unavyohifadhi, tuombe tuongeze kikomo badala ya kurudia maombi licha ya kukataliwa.

Kurudia maombi kwa usalama (idempotency)

Endpoint zinazofunga pesa au huduma — kuunda oda au uhifadhi, kutoa, kughairi — zinahitaji kichwa cha Idempotency-Key (mfuatano wowote wa kipekee wa hadi vibambo 128, UUID ni bora). Kujaribu tena kwa ufunguo ule ule hurudisha jibu la awali badala ya kuunda nakala; mwili tofauti chini ya ufunguo uliotumika tena hujibu 409.

Matoleo

Toleo liko kwenye njia (/v1). Mabadiliko ya nyongeza — sehemu mpya za hiari, thamani mpya za enum, endpoint mpya — hutolewa bila kupandisha toleo, kwa hiyo changanua kwa tahadhari na upuuze sehemu usizozijua. Mabadiliko yanayovunja upatanifu hupata toleo kuu jipya pamoja na kipindi cha kuhamia; mwongozo wa Kumbukumbu ya mabadiliko unaorodhesha kila badiliko.