Skip to main content
Version: Latest

Listado de Todas las ciudades

Se consulta todas las ciudades disponibles.

Las ciudades disponibles en formato json en esta ruta: https://app.aveonline.co/assets/resources/public/listadociudades.json

Request 🚀​

url​

https://app.aveonline.co/api/box/v1.0/ciudad.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "listarTodosDane"
  • data* String Nombre de la ciudad que se desea buscar
  • registros* Number Cantidad de registros relacionados a la búsqueda que se desean visualizar

Ejemplo​

{
  "tipo": "listarTodosDane",
  "data": "",
  "registros": ""
}

Response 📄​

Success​

  • status String Estado del resultado
  • message String Mensaje de respuesta
  • ciudades Array Object -> [{}]
    • Numericociudad Number Identificador interno del nombre de la ciudad
    • nombre String Nombre de la ciudad con el formato adecuado
    • Numericocodigodian Number Identificador interno de la ciudad
    • codigodian String Codigo dian de 8 posiciones de la ciudad

Ejemplo​

{
  "status": "ok",
  "message": "registros encontrados",
  "ciudades": [
    {
      "0": "97001012",
      "codigodian": "97001012",
      "1": "12 DE OCTUBRE(VAUPES)",
      "nombre": "12 DE OCTUBRE(VAUPES)"
    },
    {
      "0": "05002000",
      "codigodian": "05002000",
      "1": "ABEJORRAL(ANTIOQUIA)",
      "nombre": "ABEJORRAL(ANTIOQUIA)"
    }
  ]
}

Error​

Campo data vacío​

{
  "status": "error",
  "message": "El campo data no puede estar vacio"
}

Campo data numérico​

{
  "status": "error",
  "message": "El campo data no puede ser numerico"
}

No se encuentran datos asociados​

{
  "status": "error",
  "message": "registros no encontrados",
  "ciudades": []
}