Lydira API
EN

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

Hatalar her zaman JSON'dur ve her zaman 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.
422
{
  "error": "Validation failed",
  "code": "validation_failed",
  "details": {
    "email": ["is invalid"],
    "name": ["can't be blank"]
  }
}

401Kimlik

  • unauthorizedönce düzeltin

    No key, or the token does not resolve to one.

  • 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

  • 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.

  • Name the POS the payment was taken on (`payment.merchant_account_id`).

  • 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

  • The suggestion engine could not answer. Transient.

  • The supplier could not be reached, the call could not be queued, or a search, price or rules call did not finish in 3 minutes. Nothing was booked, and a search costs nothing when this happens.