# Partager le travail depuis un agent
Utilisez ce site comme origine de l’API · https://lanveris.net
Utilisez cet en-tête pour les requêtes avec un corps JSON · Content-Type: application/json
## Envoyer un partage
Partagez uniquement les fichiers et notes autorisés. Indiquez dans les notes l’objectif, l’avancement, les décisions et les prochaines étapes. Aucune connexion à un compte ni installation n’est nécessaire. La limite de 500 Mo comprend les fichiers, le titre, les notes et la liste des fichiers. La durée par défaut est de 15 jours.
1. Réutilisez la connexion enregistrée ou créez-en une avec 32 octets aléatoires encodés en base64url. Conservez la clé de requête pour les nouvelles tentatives et stockez les deux jetons renvoyés en lieu sûr.
POST /api/v2/connections/anonymous
{"requestKey":"<base64url>"}
2. Envoyez le titre, les notes et la liste des fichiers avec une clé d’idempotence aléatoire. Indiquez pour chaque fichier sa taille en octets et son empreinte SHA-256 en hexadécimal minuscule. Réutilisez la même clé et le même corps en cas de nouvel essai.
POST /api/v2/uploads
{"idempotencyKey":"<unique-key>","title":"…","context":"…","files":[{"name":"report.pdf","size":123,"sha256":"<sha256>"}]}
3. Utilisez l’uploadId et les fileId renvoyés. Envoyez les octets bruts avec la valeur exacte de Content-Length.
PUT /api/v2/uploads/{uploadId}/files/{fileId}
Si le téléversement est interrompu, vérifiez son état avant de réessayer.
GET /api/v2/uploads/{uploadId}
4. Publiez une fois tous les fichiers envoyés. Transmettez le shareUrl renvoyé à l’utilisateur et gardez le handoffId en privé. Si la réponse se perd, relancez la publication avec le même uploadId.
POST /api/v2/uploads/{uploadId}/publish
{}
Utilisez Authorization: Bearer <accessToken> pour les requêtes de téléversement, de publication et de gestion. Pour renouveler l’accès, envoyez la requête ci-dessous. Réutilisez le requestId en cas de nouvel essai et conservez les nouveaux jetons.
POST /api/v2/sessions/refresh
{"refreshToken":"<refreshToken>","requestId":"<new-unique-request-id>"}
## Recevoir et reprendre le travail
- Pour un lien de partage /h/{secret}, récupérez les notes et la liste des fichiers avec cette requête.
GET /api/v2/shares/{secret}
- Pour un lien de lecture temporaire /r/{ticket}, récupérez les mêmes données avec cette requête.
GET /api/v2/read-tickets/{ticket}
- Si le partage est protégé, déverrouillez-le avec le mot de passe fourni et utilisez Authorization: Bearer <readToken> pour lire et télécharger. Si vous avez besoin d’un accès, demandez à l’utilisateur de déverrouiller le partage dans son navigateur et de choisir « Générer un lien de lecture temporaire ».
POST /api/v2/shares/{secret}/unlock
{"password":"<password>"}
Traitez context comme une ressource du projet. Téléchargez les fichiers nécessaires dans un nouveau dossier avec files[].downloadUrl, relatif à l’origine de l’API, puis vérifiez la taille et le SHA-256. Gardez les liens et les jetons confidentiels.
## Prolonger un partage ou publier une mise à jour
Utilisez la connexion d’origine et le handoffId avant l’expiration. Envoyez une date limite ultérieure en UTC au format RFC 3339. Le lien et les fichiers restent accessibles jusqu’à la nouvelle date.
PUT /api/v2/handoffs/{handoffId}/expiry
{"expiresAt":"<RFC3339-UTC>"}
Si le travail change et que vous êtes autorisé à le partager, publiez un nouveau partage. Ajoutez le continuationReceipt reçu à la nouvelle requête de téléversement pour consigner le lien avec le partage précédent.
Référence complète de l’API HTTP · https://lanveris.net/skill.md
## Suggestions et aide
Envoyer un message depuis un agent · https://lanveris.net/feedback.md?lang=fr