GET /api/v1/playbooks

Devuelve la lista de playbooks disponibles: las combinaciones de conduct_type y language que el endpoint de análisis acepta como valores válidos.

Autenticación

Requiere API key con el scope playbooks:list.

Authorization: Bearer vario_TU_API_KEY

Parámetros

Este endpoint no acepta body ni query parameters.

Response

HTTP 200 — éxito

{
  "playbooks": [PlaybookEntry]
}

Estructura del response

Campo	Tipo	Descripción
`playbooks`	`array`	Lista de objetos `PlaybookEntry`. Puede crecer en versiones futuras.

PlaybookEntry

Campo	Tipo	Descripción
`conduct_type`	`string`	Identificador de la conducta. Usar este valor en el campo `playbook` de `POST /analyze`.
`languages`	`array[string]`	Códigos ISO 639-1 de los idiomas soportados para este playbook.
`description`	`string`	Descripción breve de la conducta.
`version`	`string`	Versión del playbook.

Conductas disponibles

`conduct_type`	Conducta	Idiomas
`price_fixing`	Coordinación de precios	`es`, `en`
`bid_rigging`	Manipulación de licitaciones	`es`, `en`
`bribery`	Soborno y anticorrupción	`es`, `en`
`market_manipulation`	Abuso de mercado	`es`, `en`
`information_exchange`	Intercambio de información	`es`, `en`
`group_boycott`	Boicot colectivo	`es`, `en`
`conflict_of_interest`	Conflictos de interés no declarados y autocontratación	`es`, `en`
`insider_trading`	Uso de información privilegiada y tipping	`es`, `en`
`internal_fraud`	Fraude interno, malversación y fraude de gastos	`es`, `en`

Cuándo llamar a este endpoint

Al inicializar la integración: obtén los valores válidos de conduct_type antes de construir cualquier request a POST /analyze. Enviar un playbook no reconocido devuelve 400 INVALID_PLAYBOOK.
Para detectar playbooks nuevos: vario incorporará nuevas conductas en versiones futuras. Llama a este endpoint de forma dinámica en lugar de hardcodear los valores, para que tu integración los soporte automáticamente.

Ejemplo completo

Request:

curl https://api.vario.lat/v1/playbooks \
  -H "Authorization: Bearer vario_TU_API_KEY"

Response:

{
  "playbooks": [
    {
      "conduct_type": "price_fixing",
      "languages": ["es", "en"],
      "description": "Coordinación de precios entre competidores",
      "version": "1.0"
    },
    {
      "conduct_type": "bid_rigging",
      "languages": ["es", "en"],
      "description": "Manipulación de licitaciones y procesos de compra",
      "version": "1.0"
    },
    {
      "conduct_type": "bribery",
      "languages": ["es", "en"],
      "description": "Soborno y conductas contrarias a normas anticorrupción",
      "version": "1.0"
    },
    {
      "conduct_type": "market_manipulation",
      "languages": ["es", "en"],
      "description": "Abuso de mercado",
      "version": "1.0"
    },
    {
      "conduct_type": "information_exchange",
      "languages": ["es", "en"],
      "description": "Intercambio de información comercialmente sensible entre competidores",
      "version": "1.0"
    },
    {
      "conduct_type": "group_boycott",
      "languages": ["es", "en"],
      "description": "Boicot colectivo y prácticas de exclusión concertada",
      "version": "1.0"
    },
    {
      "conduct_type": "conflict_of_interest",
      "languages": ["es", "en"],
      "description": "Conflictos de interés no declarados y autocontratación",
      "version": "1.0.0"
    },
    {
      "conduct_type": "insider_trading",
      "languages": ["es", "en"],
      "description": "Uso de información privilegiada y tipping",
      "version": "1.0.0"
    },
    {
      "conduct_type": "internal_fraud",
      "languages": ["es", "en"],
      "description": "Fraude interno, malversación y fraude de gastos",
      "version": "1.0.0"
    }
  ]
}

Errores posibles

HTTP	Código	Descripción
`401`	`MISSING_AUTH`	Header `Authorization` ausente.
`401`	`INVALID_API_KEY`	API key no encontrada, expirada o inactiva.
`402`	`SUBSCRIPTION_REQUIRED`	El tenant no tiene suscripción activa.
`403`	`INSUFFICIENT_SCOPE`	La API key no tiene el scope `playbooks:list`.
`429`	`RATE_LIMIT_EXCEEDED`	Rate limit alcanzado. Consulta el header `Retry-After`.

Nota sobre versiones futuras

vario añadirá nuevos playbooks y nuevos idiomas en versiones futuras. Se recomienda llamar a GET /playbooks de forma dinámica al iniciar cada sesión de integración en lugar de hardcodear la lista de conductas. Los valores de conduct_type son estables una vez publicados — no se renombran entre versiones menores.