Saltar al contenido
# 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