Errores y límites

La forma de un error

Cada respuesta tiene un campo ok. Cuando se rechaza una petición, ok es false y error es una frase que dice qué salió mal y qué hacer al respecto. Está escrita para mostrarse a una persona tal cual.

{ "ok": false, "error": "No such app on this account." }

Un rechazo no tiene más campos, con una excepción: una edición que ha empezado y luego no pudo ejecutarse por falta de créditos lleva además outOfCredits: true.

Códigos de estado

Por privacidad, «no existe esa aplicación» y «una aplicación que no puedes usar» dan el mismo 404. De lo contrario, una clave podría servir para averiguar qué aplicaciones existen. Eso incluye una aplicación que solo puedes ver cuando la llamada necesita un editor.

Quién puede hacer qué

Tu rol en la aplicación decide qué llamadas funcionan:

Límites

Los límites por hora son un ritmo, no una asignación. Están ahí para un script que se ejecuta más rápido de lo que puede una persona, y nadie que trabaje a mano los alcanza. Lo que te limita en la práctica son tus créditos.

Las ediciones también están limitadas por tus créditos y por tu plan, exactamente igual que en el editor. Cuando una edición no puede ejecutarse por ese motivo, la respuesta es 200 con ok: false y un error que dice por qué. La página de la tienda es distinta: cuando se rechaza aún no ha empezado, así que responde 402.

Qué límite responde cómo

• Publish responde 429 cuando se han usado las 100 del día, y 503 cuando no se puede llegar al propio limitador.
• Store page responde 429 por el límite de la hora, 503 cuando no se puede llegar al limitador, y 402 por el plan y los créditos.
• Edit responde 200 con ok: false, y error lleva la frase. La del límite por hora dice You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.