GET
/api/mod/ventas/{espacio}/leads/Los leads del espacio
Los clientes que el agente registró al cotizar o al comprar, el más reciente primero. Es tu embudo: quién preguntó, por qué producto y en qué estado está.
- 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 Ventas. |
| estado | string, query | no | Solo los de ese estado: nuevo, contactado, ganado o cerrado. |
| limit | int, query | no | Cuántos, de 1 a 1000. Por defecto 200. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| leads | array | El más reciente primero. Cada uno, con los campos de GET leads/{lead}. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Ventas | módulo no habilitado para este espacio. |
| 400 | estado no es nuevo, contactado, ganado ni cerrado | estado inválido: ['cerrado', 'contactado', 'ganado', 'nuevo'] |
| 422 | Falta un campo obligatorio o uno no es de su tipo (detail es una lista) | — |
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
- Copia la ruta tal cual, con su barra final. Sin ella la respuesta es un 307 sin destino, no la conversación.