Errores - Booklift

Todos los errores tienen la misma forma:

{
  "error": {
    "codigo": "sin_creditos",
    "mensaje": "Has agotado los créditos de este mes. Amplía tu plan para seguir."
  }
}

Programa contra codigo, nunca contra mensaje. El código es estable; el mensaje puede reescribirse o traducirse en cualquier momento.

Tabla de códigos

HTTP	`codigo`	Qué hacer
400	`peticion_invalida`	Revisa el cuerpo. No reintentes: fallará igual.
400	`falta_organizacion`	Solo afecta a claves internas.
401	`sin_credenciales`	Falta la cabecera `Authorization`.
401	`clave_invalida`	Clave mal escrita o revocada. No reintentes.
402	`sin_creditos`	Amplía el plan o espera al siguiente periodo.
404	`negocio_no_encontrado`	Ese negocio no es de tu organización.
409	`agente_no_desplegado`	El negocio existe pero aún no está `activo`.
502	`agente_no_disponible`	Fallo temporal. Reintenta; no se te ha cobrado.
500	`error_interno`	Fallo nuestro. Reintenta y avísanos si persiste.

Qué reintentar

Solo 502 y 500, y con espera creciente:

async function conReintento(fn, intentos = 3) {
  for (let i = 0; i < intentos; i++) {
    try {
      return await fn();
    } catch (e) {
      // Un 4xx no mejora reintentando: la petición es incorrecta.
      if (e.estado < 500) throw e;
      if (i === intentos - 1) throw e;
      await new Promise((r) => setTimeout(r, 2 ** i * 1000));
    }
  }
}

Reintentar un 401 o un 404 solo gasta tiempo: el resultado será el mismo.

Sobre el 404

Devolvemos 404 tanto si el negocio no existe como si existe pero es de otra organización. Distinguirlos te diría qué negocios hay dados de alta en Booklift, así que no lo hacemos. No es un fallo de la documentación.

⌘I