Empresas
Endpoints para consulta de empresas vinculadas al token de integración.
Listar Empresas
GET /api/companies
Retorna una lista de empresas asociadas al token del usuario.
Casos de uso:
- Obtener IDs de empresas para filtros
- Validar acceso a empresas específicas
- Popular selectores de empresa en integraciones
Ejemplo de Solicitud
bash
curl -X GET "https://api-b2s.experienciab2s.com/api/companies" \
-H "Authorization: Bearer SU_TOKEN"Respuesta Exitosa (200)
json
[
{ "id": "103a525c-0ce3-4182-a504-aad595425233", "name": "Empresa 1" },
{ "id": "203a525c-0ce3-4182-a504-aad595425233", "name": "Empresa 2" },
{ "id": "303a525c-0ce3-4182-a504-aad595425233", "name": "Empresa 3" }
]Estructura de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
id | string | ID único de la empresa (UUID) |
name | string | Nombre de la empresa |
Códigos de Respuesta
| Código | Descripción |
|---|---|
| 200 | Empresas encontradas |
| 401 | Token ausente o inválido |
| 403 | Token inválido o usuario no autorizado |
| 404 | Token de integración no encontrado |