Kılavuzlar
Hatalar
Her ret bir kod söyler. Durum koduna değil bu koda göre dallanın; üç farklı 403, üç farklı çözüm ister.
Zarf
error ile code taşır. 422 ayrıca details taşır. Bu alan reddedilen her niteliği gerekçelerine eşler, böylece istemci mesajı sorunun çıktığı alanın yanına koyabilir.{
"error": "Validation failed",
"code": "validation_failed",
"details": {
"email": ["is invalid"],
"name": ["can't be blank"]
}
}401Kimlik
- key_revokedönce düzeltin
The key existed and was switched off. Issue a new one.
- key_expiredönce düzeltin
The key passed its expiry date. Issue a new one.
402Kota
- search_quota_exhaustedönce düzeltin
The month's searches and the search wallet are both used up. Buy a pack or wait for the reset.
403İzin
- ip_not_allowedönce düzeltin
The credential is fine, the source address is not on the key's allowlist.
- plan_upgrade_requiredönce düzeltin
The account's plan does not include API access at all.
- insufficient_scopeönce düzeltin
The key is narrow and this endpoint is outside it.
- forbiddenönce düzeltin
The role bound to the key does not permit this operation.
- plan_gatedönce düzeltin
The plan does not include this particular report.
- misconfiguredönce düzeltin
The account has no active owner for the key to act as. The agency must fix this.
- traveler_scopeönce düzeltin
A traveller token was presented outside its own routes.
- addon_requiredönce düzeltin
The account lacks an add-on this surface needs; `details.missing` names it.
404Bulunamadı
- not_foundönce düzeltin
No such record, or it belongs to another account.
- unknown_entityönce düzeltin
The import entity key is not in the registry.
- operation_not_foundönce düzeltin
No operation by that id for this key: expired (a hold, ticket, release or purchase sent with an `Idempotency-Key` is kept 7 days, any other call 15 minutes), it can no longer be read, or another key's. On a hold, ticket or purchase, send the call again with the same `Idempotency-Key` and body; it replays the first answer or answers `booking_unresolved` with the booking its key claimed. Send a release again as it was. Do not refund the card on this answer alone.
409Çakışma
- idempotency_conflictdenenebilir
The first call with this key is still running. Wait out `Retry-After` and send it again; once the first one is done the repeat replays its answer.
- price_changedönce düzeltin
The fare moved. Price the offer again and confirm the new total with your customer.
- approval_requiredönce düzeltin
The agency approves this ticket first. Call ticket again once it is approved.
- credit_blockedönce düzeltin
The buyer's credit limit does not allow this hold.
- supplier_balanceönce düzeltin
The agency's balance with the supplier does not cover this ticket.
- journey_partialönce düzeltin
Some tickets of a multi-part journey were issued and one was not.
- hold_expiredönce düzeltin
The hold is no longer open. Search again.
- not_cancellableönce düzeltin
This booking can no longer be released here.
- no_connectionönce düzeltin
The agency has no supplier connection that can serve this call.
- not_supportedönce düzeltin
The supplier connection does not support this call.
410Süresi doldu
- offer_expiredönce düzeltin
The search or the offer has expired. Search again.
422Reddedildi
- validation_failedönce düzeltin
The record was rejected. `details` names the fields.
- idempotency_key_reuseönce düzeltin
That key was already used for a different body or path.
- entity_not_writableönce düzeltin
The entity broadcasts and can be read, but cannot be pushed.
- no_rowsönce düzeltin
The ingest body carried no rows.
- too_many_rowsönce düzeltin
The batch is over the per-request row ceiling. Split it.
- no_companyönce düzeltin
The account has no company to file the rows against.
- unknown_branchönce düzeltin
The `branch_id` is not one of this account's. `GET /api/v1/workspace` lists them.
- invalid_stageönce düzeltin
No such lead stage.
- conversion_failedönce düzeltin
The lead could not be converted. Usually it already was.
- provider_rejectedönce düzeltin
The supplier refused the request; `details.provider_message` carries its reason.
- payment_mismatchönce düzeltin
The payment amount or currency differs from the booking total.
- merchant_account_requiredönce düzeltin
Name the POS the payment was taken on (`payment.merchant_account_id`).
- idempotency_key_requiredönce düzeltin
This call moves money or seats and needs an `Idempotency-Key` header.
- invalid_price_tokenönce düzeltin
The price token is missing, expired or belongs to another offer. Price again.
- payer_requiredönce düzeltin
The booking has no cari to bill and the payment needs one. Send `bill_to` with a VKN, a TCKN or a passport, or `customer_id`.
429Hız sınırı
- rate_limiteddenenebilir
Too many calls in this window. Wait out `Retry-After`.
502Belirsiz
- booking_unresolvedönce düzeltin
The supplier's answer is unknown, or the call did not finish in 3 minutes. Read the booking back (`booking_id`) and refund only if it was not ticketed. A hold, ticket or purchase keeps this answer under its `Idempotency-Key`; a new attempt takes a new key.
503Geçici
- suggestions_faileddenenebilir
The suggestion engine could not answer. Transient.