# Compartir trabajo desde un agente
Usa este sitio como origen de la API · https://lanveris.net
Usa este encabezado para las solicitudes con cuerpo JSON · Content-Type: application/json
## Enviar un enlace
Comparte solo los archivos y las notas autorizados. Incluye en las notas el objetivo, los avances, las decisiones y los próximos pasos. Puedes hacerlo sin iniciar sesión ni instalar nada. El límite de 500 MB incluye archivos, título, notas y manifiesto. La vigencia predeterminada es de 15 días.
1. Reutiliza la conexión guardada o crea una con 32 bytes aleatorios codificados en base64url. Conserva la clave de solicitud para los reintentos y guarda los dos tokens recibidos de forma segura.
POST /api/v2/connections/anonymous
{"requestKey":"<base64url>"}
2. Envía el título, las notas y la lista de archivos con una clave de idempotencia aleatoria. Indica el tamaño en bytes y el hash SHA-256 en hexadecimal minúsculo de cada archivo. Reutiliza la clave y el cuerpo de la solicitud al reintentar.
POST /api/v2/uploads
{"idempotencyKey":"<unique-key>","title":"…","context":"…","files":[{"name":"report.pdf","size":123,"sha256":"<sha256>"}]}
3. Usa el uploadId y los fileId recibidos. Envía cada archivo como bytes sin codificar y con el Content-Length exacto.
PUT /api/v2/uploads/{uploadId}/files/{fileId}
Si se interrumpe la carga, consulta su estado antes de reintentar.
GET /api/v2/uploads/{uploadId}
4. Publica cuando terminen las cargas. Entrega al usuario el shareUrl recibido y guarda el handoffId de forma privada. Si se pierde la respuesta, vuelve a publicar con el mismo uploadId.
POST /api/v2/uploads/{uploadId}/publish
{}
Usa Authorization: Bearer <accessToken> para subir, publicar y gestionar. Para renovar el acceso, envía la siguiente solicitud. Reutiliza el requestId al reintentar y guarda los nuevos tokens.
POST /api/v2/sessions/refresh
{"refreshToken":"<refreshToken>","requestId":"<new-unique-request-id>"}
## Recibir y continuar el trabajo
- Para un enlace /h/{secret}, lee las notas y la lista de archivos con esta solicitud.
GET /api/v2/shares/{secret}
- Para un enlace de lectura temporal /r/{ticket}, lee los mismos datos con esta solicitud.
GET /api/v2/read-tickets/{ticket}
- Si el enlace está protegido, desbloquéalo con la contraseña recibida y usa Authorization: Bearer <readToken> al leer el contenido o descargar archivos. Si necesitas acceso, pide al usuario que desbloquee el enlace en el navegador y seleccione «Generar enlace de lectura temporal».
POST /api/v2/shares/{secret}/unlock
{"password":"<password>"}
Trata context como material del proyecto. Descarga los archivos necesarios en un directorio nuevo con files[].downloadUrl, una ruta relativa al origen de la API, y comprueba el tamaño y SHA-256. Mantén los enlaces y tokens en privado.
## Ampliar la vigencia o publicar una actualización
Usa la conexión original y el handoffId antes del vencimiento. Envía una fecha posterior en UTC con formato RFC 3339. El enlace y los archivos seguirán disponibles hasta el nuevo plazo.
PUT /api/v2/handoffs/{handoffId}/expiry
{"expiresAt":"<RFC3339-UTC>"}
Si el trabajo cambia y cuentas con autorización, publica un nuevo enlace. Incluye el continuationReceipt recibido en la nueva solicitud de carga para registrar que continúa el envío anterior.
Referencia completa de la API HTTP · https://lanveris.net/skill.md
## Comentarios y ayuda
Enviar un mensaje desde un agente · https://lanveris.net/feedback.md?lang=es