Errores y límites
Todos los códigos de error que devuelve la API de Partners y todos los límites que aplica.
Cada fallo tiene la misma forma. Ramifica en error.error_code; registra description para una persona; nunca hagas coincidir por su texto. error.error_attributes contiene los detalles que define un código, y es null para el resto.
{
"description": "story_document: el enlace sirve \"text/html\", que esta entrada no acepta. Señala al archivo en sí.",
"code": "url_type_not_allowed",
"error": {
"id": null,
"error_code": "url_type_not_allowed",
"error_attributes": null,
"user_readable_message": null,
"locale": "en"
}
}código se repite error.error_code para clientes antiguos; lee error.error_code.
Códigos de error
| HTTP | error_code | Significa | Qué hacer |
|---|---|---|---|
| 400 | invalid_request | un cuerpo o valor de entrada es incorrecto; la descripción nombra la entrada | corrígelo y reenvíalo. Nunca reintentes sin cambios |
| 400 | url_not_fetchable | no se pudo obtener un enlace, incumplió una de las reglas de enlaces o sirvió un archivo vacío | compruébalo frente a Pasar archivos por URL |
| 400 | url_type_not_allowed | el enlace sirvió un tipo de contenido que esta entrada no admite, o bytes que no son el tipo que afirmaba ser | sirve el archivo en sí, con su tipo real |
| 400 | url_too_large | el archivo supera el max_bytesde la entrada, o supera lo que le queda al proceso de su presupuesto de bytes | envía un archivo más pequeño |
| 401 | unauthorized | la clave falta, está mal formada, revocada o caducada | detente y avisa a alguien. Un reintento no puede ayudar |
| 403 | api_key_credit_limit_reached | la clave está en uno de sus propios límites de crédito; error_attributes.period indica cuál | pide a un administrador que aumente el límite de la clave en Studio, o espera a que se restablezca un límite diario o mensual |
| 403 | credits_exhausted | la organización se ha quedado sin créditos | recarga la organización |
| 403 | access_denied | org_id no es la organización de la clave, la clave carece del alcance, o puede que no pueda ejecutar este flujo de trabajo | comprueba los alcances de la clave y la lista de अनुमति de flujo de trabajo en Studio |
| 404 | entity_not_found | no existe tal flujo de trabajo, proyecto, ejecución o endpoint de webhook en tu organización, o una ejecución de un flujo de trabajo fuera de la lista permitida de la clave | comprueba el id |
| 409 | idempotency_conflict | el mismo idempotency_key llegó con un cuerpo diferente | usa una nueva clave para trabajo nuevo |
| 429 | too_many_requests | se alcanzó un límite de lectura | espera Retry-After y luego reenvía |
| 500 | internal_error | nuestro | reintenta con retroceso; si persiste, envíanos el x-morphic-trace-id |
Límites
| Límite | Predeterminado | Notas |
|---|---|---|
| Créditos | los propios límites de la clave | un total que tiene cada clave, y límites diarios y mensuales opcionales — consulta Límites de crédito |
| Lecturas de una ejecución | 30 por minuto, por clave | una lectura por minuto por ejecución es más que suficiente; wait=45 es aún más barato |
| Lecturas de todas las ejecuciones | 1.200 por minuto, por clave | espacio para seguir cientos de ejecuciones a la vez |
| Enlaces por ejecución | 10 | entre todas las entradas de archivo juntas |
| Bytes por ejecución | 500 MB | entre todos los enlaces juntos |
| Bytes por archivo | de la entrada max_bytes | documentos de hasta 100 MB; los límites de medios son por entrada |
| Duración de la ejecución | 24 horas | una ejecución que no se haya terminado antes de expires_at se convierte en caducada |
| Endpoints de webhook | 10 por organización | elimina uno antes de añadir otro |
Iniciar ejecuciones nunca está sujeto a limitación de tasa: los límites de crédito de una clave restringen lo que puede gastar un bucle de reintentos, y un idempotency_key convierte un reintento en una reproducción. Los límites de lectura se aumentan a petición para un volumen que hayamos hablado.
Facturación
Los créditos de una ejecución iniciada por API se facturan a la organización propietaria de la clave, y se cargan a la clave que la inició. Un administrador ve el gasto en Facturación y uso → Actividad de créditos en Studio, y los límites de cada clave en la Claves de API página.
Una ejecución sigue contando contra la clave que la inició incluso si alguien entra en el chat en Studio y la toma el control, así que el presupuesto restante de la clave es el presupuesto de toda la ejecución.
Una ejecución rechazada antes de empezar — un enlace malo, o una clave o organización sin crédito — no cuesta nada. Una ejecución que falla a mitad de camino ha consumido lo que hayan costado sus pasos completados; credits_used en la ejecución indica cuánto.