Códigos de error

Cuando error es true en la respuesta, el campo code_error indica qué salió mal.

Estructura de error

{
  "error": true,
  "code_error": 102,
  "error_message": "La longitud del cp es inválida",
  "response": null
}

Errores globales (todos los endpoints)

Estos errores pueden ocurrir en cualquier petición, independientemente del endpoint.

Errores de info_cp y search_cp

Errores de search_cp

Errores de catálogos (300+)

Los endpoints de catálogos (get_municipio_por_estado, get_cp_por_municipio, etc.) pueden devolver errores en el rango 301–2303 cuando falta un parámetro requerido o tiene formato inválido. El campo error_message describe el parámetro específico con el problema.

Código 0 — Sin error

Cuando code_error es 0, la petición fue exitosa.

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": { }
}

Manejo recomendado

const response = await fetch(
  "https://api.copomex.com/query/info_cp/06600?type=simplified&token=tu_token"
);
const data = await response.json();
 
if (data.error) {
  switch (data.code_error) {
    case 3:
      console.error("Token inválido — verifica tu configuración");
      break;
    case 4:
      console.error("Consultas agotadas — adquiere más en el panel");