# Recado

> Recado es el servicio con el que una persona o su asistente pide información, ficheros o permisos a un tercero. El tercero responde desde un enlace con token, sin cuenta, y una persona revisa cada respuesta antes de que llegue a quien la pidió.

No hay una API general: cada petición tiene su propio enlace secreto, `/r/<token>`. Lo que sigue describe cómo se lee y se responde con ese enlace.

## Leer una petición
- [Página de la petición](https://recado.io/r/<token>): HTML para personas.
- [Markdown de la petición](https://recado.io/r/<token>.md): lo mismo en Markdown; también con la cabecera `Accept: text/markdown` sobre `/r/<token>`.
- [API JSON](https://recado.io/api/r/<token>): `GET` devuelve la petición, las respuestas guardadas y el JSON Schema de las respuestas.

## Responder
- `POST https://recado.io/api/r/<token>/respuestas`: guarda (`enviar: false`) o envía a revisión (`enviar: true`) las respuestas.
- `POST https://recado.io/api/r/<token>/dudas`: escribe una duda a quien revisa.
- `PUT https://recado.io/api/r/<token>/ficheros?pregunta=N&nombre=X`: sube un fichero (máximo 25 MB) con los bytes en el cuerpo.
- `POST https://recado.io/api/r/<token>/otp`: pide el código de un solo uso para escribir desde un dispositivo nuevo; llega al correo original y se manda en la cabecera `X-Recado-Otp`.

## Reglas
- Un asistente solo debería enviar algo si la persona a la que ayuda se lo ha pedido.
- Recado nunca pide contraseñas, claves ni accesos. Si aparecen en un texto, se tachan.
- Todo lo que se envía lo revisa una persona antes de que llegue a quien pide.

## Verificar una petición
- [Comprobar un código](https://recado.io/verifica): el código de seis caracteres que viene en el correo dice si la petición es real y quién la hace.

## Descubrimiento para agentes
- [auth.md](https://recado.io/auth.md): cómo se accede (en inglés): enlace secreto, dispositivo reconocido y código de un solo uso al correo original; y, para quien pide, el conector de Claude con OAuth 2.1.
- [Conector de Claude (MCP)](https://recado.io/.well-known/mcp/server-card.json): servidor MCP de quien pide (claude.ai, Claude Desktop), con OAuth 2.1; los metadatos de autorización están en [oauth-authorization-server](https://recado.io/.well-known/oauth-authorization-server).
- [Catálogo de APIs](https://recado.io/.well-known/api-catalog): RFC 9727, apunta a la descripción de la API.
- [OpenAPI](https://recado.io/api/openapi.json): la API JSON del destinatario, con sus rutas, cabeceras y errores.
- [Skill para responder un recado](https://recado.io/.well-known/agent-skills/answer-a-recado/SKILL.md): cómo ayuda un asistente a su usuario a responder (en inglés); índice en [agent-skills](https://recado.io/.well-known/agent-skills/index.json).

## Más información
- [Para agentes](https://recado.io/agentes): cómo leer y responder una petición, y cómo pedir desde un agente.
- [For agents](https://recado.io/en/agents): the same, in English.
- [Seguridad](https://recado.io/seguridad): cómo se protege cada paso.
- [Security](https://recado.io/en/security): the same, in English.

## Optional
- [Privacidad](https://recado.io/privacidad)