GET
/api/mod/productos/{espacio}/inventory/suggestAlternativas con stock
Nombres de productos activos que sí tienen stock: lo que ofrecer cuando lo que piden está agotado.
- 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 Productos. |
| exclude_variant_id | string, query | no | La variante agotada, para no proponerla. |
| limit | int, query | no | Cuántos. Por defecto 3. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| suggestions | string[] | Nombres de producto, por orden alfabético. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Productos | módulo no habilitado para este espacio. |
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
- No mira si se parecen a lo agotado: son productos con stock, sin más. Para algo parecido, busca y comprueba su disponibilidad.