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.
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.
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.
409Çakışma
- idempotency_conflictdenenebilir
The first call with this key is still running. Wait out `Retry-After` and repeat.
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.
503Geçici
- suggestions_faileddenenebilir
The suggestion engine could not answer. Transient.