# Compartilhar trabalho com um agente
Use este site como origem da API · https://lanveris.net
Use este cabeçalho em solicitações com corpo JSON · Content-Type: application/json
## Enviar um compartilhamento
Compartilhe apenas os arquivos e as notas autorizados. Inclua nas notas o objetivo, o andamento, as decisões e os próximos passos. Você pode fazer isso sem login ou instalação. O limite de 500 MB inclui arquivos, título, notas e manifesto. A validade padrão é de 15 dias.
1. Reutilize a conexão salva ou crie uma com 32 bytes aleatórios codificados em base64url. Guarde a chave da solicitação para novas tentativas e armazene os dois tokens recebidos em local seguro.
POST /api/v2/connections/anonymous
{"requestKey":"<base64url>"}
2. Envie o título, as notas e a lista de arquivos com uma chave de idempotência aleatória. Para cada arquivo, informe o tamanho em bytes e o SHA-256 em hexadecimal minúsculo. Use a mesma chave e o mesmo corpo ao tentar novamente.
POST /api/v2/uploads
{"idempotencyKey":"<unique-key>","title":"…","context":"…","files":[{"name":"report.pdf","size":123,"sha256":"<sha256>"}]}
3. Use o uploadId e os fileId retornados. Envie os bytes brutos de cada arquivo com o Content-Length exato.
PUT /api/v2/uploads/{uploadId}/files/{fileId}
Se o upload for interrompido, confira o status antes de tentar novamente.
GET /api/v2/uploads/{uploadId}
4. Publique depois de enviar todos os arquivos. Entregue ao usuário o shareUrl retornado e guarde o handoffId em local privado. Se a resposta se perder, tente publicar com o mesmo uploadId.
POST /api/v2/uploads/{uploadId}/publish
{}
Use Authorization: Bearer <accessToken> para fazer upload, publicar e gerenciar. Para renovar o acesso, envie a solicitação abaixo. Em uma nova tentativa, reutilize o requestId e salve os novos tokens quando a solicitação for concluída.
POST /api/v2/sessions/refresh
{"refreshToken":"<refreshToken>","requestId":"<new-unique-request-id>"}
## Receber e continuar o trabalho
- Para um link /h/{secret}, leia as notas e a lista de arquivos com esta solicitação.
GET /api/v2/shares/{secret}
- Para um link de leitura temporário /r/{ticket}, leia os mesmos dados com esta solicitação.
GET /api/v2/read-tickets/{ticket}
- Se o link estiver protegido, desbloqueie com a senha fornecida e use Authorization: Bearer <readToken> para consultar o compartilhamento e baixar arquivos. Se precisar de acesso, peça ao usuário que desbloqueie o link no navegador e selecione “Gerar link de leitura temporário”.
POST /api/v2/shares/{secret}/unlock
{"password":"<password>"}
Trate context como material do projeto. Baixe os arquivos necessários em uma nova pasta usando files[].downloadUrl, relativo à origem da API, e confira o tamanho e o SHA-256. Mantenha os links e tokens privados.
## Estender a validade ou publicar uma atualização
Use a conexão original e o handoffId antes do vencimento. Envie um prazo posterior em UTC no formato RFC 3339. O mesmo link e os mesmos arquivos ficam disponíveis até a nova data.
PUT /api/v2/handoffs/{handoffId}/expiry
{"expiresAt":"<RFC3339-UTC>"}
Se o trabalho mudar e houver autorização, publique um novo compartilhamento. Inclua o continuationReceipt recebido na nova solicitação de upload para registrar que ela dá continuidade ao compartilhamento anterior.
Referência completa da API HTTP · https://lanveris.net/skill.md
## Sugestões e ajuda
Enviar uma mensagem por meio de um agente · https://lanveris.net/feedback.md?lang=pt-BR