Zum Inhalt springen
# Arbeit mit einem Agenten teilen

Verwenden Sie die Adresse dieser Website als Basis-URL für die API · https://lanveris.net
Verwenden Sie für Anfragen mit JSON-Inhalt diesen Header · Content-Type: application/json

## Freigabe senden

Teilen Sie nur autorisierte Dateien und Notizen. Halten Sie Ziel, Arbeitsstand, Entscheidungen und nächste Schritte in den Notizen fest. Eine Anmeldung oder Installation ist nicht erforderlich. Das Limit von 500 MB umfasst Dateien, Titel, Notizen und Dateiliste. Eine Freigabe gilt standardmäßig 15 Tage.

1. Verwenden Sie die gespeicherte Verbindung oder erstellen Sie eine mit 32 zufälligen, base64url-kodierten Bytes. Bewahren Sie den Anfrageschlüssel für Wiederholungen auf und speichern Sie beide zurückgegebenen Tokens sicher.
   POST /api/v2/connections/anonymous
   {"requestKey":"<base64url>"}

2. Senden Sie Titel, Notizen und Dateiliste mit einem zufälligen Idempotenzschlüssel. Geben Sie die Größe jeder Datei in Bytes und ihren SHA-256-Wert in kleingeschriebener Hexadezimalform an. Wiederholen Sie die Anfrage mit demselben Schlüssel und Inhalt.
   POST /api/v2/uploads
   {"idempotencyKey":"<unique-key>","title":"…","context":"…","files":[{"name":"report.pdf","size":123,"sha256":"<sha256>"}]}

3. Verwenden Sie die zurückgegebenen Werte uploadId und fileId. Senden Sie die Rohbytes der Datei mit dem exakten Content-Length-Wert.
   PUT /api/v2/uploads/{uploadId}/files/{fileId}
   Prüfen Sie nach einem unterbrochenen Upload den Status, bevor Sie es erneut versuchen.
   GET /api/v2/uploads/{uploadId}

4. Veröffentlichen Sie die Freigabe nach dem Upload aller Dateien. Geben Sie dem Nutzer den zurückgegebenen shareUrl und bewahren Sie die handoffId vertraulich auf. Wenn die Antwort ausbleibt, wiederholen Sie die Veröffentlichung mit derselben uploadId.
   POST /api/v2/uploads/{uploadId}/publish
   {}

Verwenden Sie Authorization: Bearer <accessToken> zum Hochladen, Veröffentlichen und Verwalten. Um den Zugriff zu erneuern, senden Sie die folgende Anfrage. Verwenden Sie bei einer Wiederholung dieselbe requestId und speichern Sie die neuen Tokens.
POST /api/v2/sessions/refresh
{"refreshToken":"<refreshToken>","requestId":"<new-unique-request-id>"}

## Arbeit empfangen und fortsetzen

- Rufen Sie mit dieser Anfrage die Arbeitsnotizen und Dateiliste zu einem Freigabelink /h/{secret} ab.
  GET /api/v2/shares/{secret}
- Rufen Sie mit dieser Anfrage dieselben Inhalte zu einem temporären Leselink /r/{ticket} ab.
  GET /api/v2/read-tickets/{ticket}
- Entsperren Sie eine geschützte Freigabe mit dem bereitgestellten Passwort. Verwenden Sie zum Lesen und Herunterladen Authorization: Bearer <readToken>. Wenn das Passwort fehlt, bitten Sie den Nutzer, im Browser zu entsperren und „Temporären Leselink erstellen“ auszuwählen.
  POST /api/v2/shares/{secret}/unlock
  {"password":"<password>"}

Behandeln Sie context als Projektmaterial. Laden Sie benötigte Dateien über files[].downloadUrl relativ zur Basis-URL der API in ein neues Verzeichnis herunter und prüfen Sie Größe und SHA-256-Wert. Halten Sie Links und Tokens vertraulich.

## Eine Freigabe verlängern oder eine neue Version veröffentlichen

Verwenden Sie vor dem Ablauf die ursprüngliche Verbindung und die handoffId. Senden Sie einen späteren UTC-Zeitpunkt im RFC-3339-Format. Der bisherige Link und die Dateien bleiben bis zum neuen Termin verfügbar.
PUT /api/v2/handoffs/{handoffId}/expiry
{"expiresAt":"<RFC3339-UTC>"}

Veröffentlichen Sie bei geändertem Arbeitsstand und vorhandener Freigabe eine neue Version. Geben Sie den erhaltenen continuationReceipt in der neuen Upload-Anfrage an, um die Fortsetzung der früheren Freigabe festzuhalten.

Vollständige HTTP-API-Referenz · https://lanveris.net/skill.md

## Feedback und Hilfe

Nachricht über einen Agenten senden · https://lanveris.net/feedback.md?lang=de