GET
/api/mod/comercial/{espacio}/tarifas/ciudadesBusca una ciudad en la tabla
Las ciudades de la tabla activa que contienen el texto que buscas, con su zona. Sirve para un autocompletado o para comprobar un destino.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Comercial. |
| q | string, query | SÍ | Lo que buscas, al menos 1 carácter. Sin importar tildes ni mayúsculas. |
| limit | int, query | no | Cuántas como mucho. Por defecto 20. |
RESPUESTA 200
Una lista JSON (sin objeto alrededor), la más corta primero.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| [].nombre_destino | string | El nombre tal como está en tu tabla. |
| [].zona | string | Su zona: Local, Nacional, Zonal… |
| [].codigo_zona | string | null | El código de zona de tu tabla, si lo trae. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Comercial | módulo no habilitado para este espacio. |
| 422 | Falta q o viene vacío | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Sin tabla activa, responde una lista vacía.
- Un municipio que tu tabla no lista no sale aquí, aunque al cotizar pueda caer en la zona Otros.