---
title: 'REST API'
description: 'Tokens, acceso Bearer, ejemplo de solicitud y enlaces a la referencia de OpenAPI.'
type: doc
locale: es
canonical: 'https://yoseno.com/es/docs/integrations/rest-api'
updated: '2026-07-30'
---

# REST API

Tokens, acceso Bearer, ejemplo de solicitud y enlaces a la referencia de OpenAPI.

La API REST está disponible en `/api/v1` y es adecuada para scripts, servicios internos, CI, exportaciones y otra automatización de servidor.

Para los endpoints protegidos se necesita un token de API personal. La solicitud se ejecuta en nombre del usuario que emitió el token y pasa las mismas comprobaciones de roles y permisos.

## Autorización

Envía el token en el encabezado HTTP:

```http
Authorization: Bearer <token>
```

Cómo emitir, almacenar y revocar los tokens se describe en el artículo
[Tokens de API](https://yoseno.com/es/docs/integrations/api-tokens.md).

## Ejemplo de solicitud

```bash
curl -sS "$PLATFORM_BASE_URL/api/v1/{org}/surveys" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PLATFORM_API_TOKEN"
```

Reemplaza `{org}` por el ID de la organización. Consulta los parámetros del endpoint concreto, el formato de la respuesta y los códigos de error en la especificación completa.

## Límites de solicitudes

La API está protegida contra sobrecarga mediante una limitación de frecuencia:
- API autorizada de la aplicación: 300 solicitudes por minuto por usuario o IP.
- Webhook del proveedor de pagos: 600 solicitudes por minuto.
- Endpoints públicos (`/status`, tarjetas de la base de conocimientos): 300 solicitudes por minuto por IP.

Al superar el límite, el servidor devuelve HTTP `429 Too Many Requests` con el encabezado `Retry-After` (número de segundos hasta reintentar) y el cuerpo del error:

```json
{
  "status": 429,
  "message": "Demasiadas solicitudes. Inténtalo de nuevo en 30 segundos.",
  "errors": {}
}
```

## Documentación completa

- [Referencia de OpenAPI](https://yoseno.com/docs/api): documentación interactiva sobre endpoints, parámetros y esquemas de respuestas.
- [OpenAPI JSON](https://yoseno.com/docs/api.json): esquema legible por máquina para generadores de clientes, Postman, Insomnia y verificaciones de contratos.

## Páginas relacionadas

- [/docs/api](https://yoseno.com/docs/api)
- [/docs/api.json](https://yoseno.com/docs/api.json)
- [Tokens de API](https://yoseno.com/es/docs/integrations/api-tokens.md) — Tokens personales y acceso bearer a \`/api/v1\`.

## Continuar leyendo

- [Acerca de la base de conocimientos](https://yoseno.com/es/docs/knowledge.md) — Catálogo de prácticas y su relación con las recomendaciones de la plataforma.