Idempotenz
Senden Sie bei `POST /api/v1/media` einen `Idempotency-Key`, damit Wiederholungen nach Netzwerkfehlern keine doppelten Uploads erzeugen.
Veröffentlichungs- und Export-Clients führen bei Netzwerkverlust, Zeitüberschreitungen und uneindeutigen Antworten Wiederholungen durch. POST /api/v1/media akzeptiert:
Idempotency-Key: <unique-string>
Semantik
- Gleicher Schlüssel + gleicher Anfrageinhalt → gleiche
media_id-Antwort (sichere Wiederholung) - Gleicher Schlüssel + anderer Inhalt → 409-Konflikt
- Schlüssel gelten für den authentifizierten Prinzipal und Arbeitsbereich
Empfehlung für Lightroom
Verwenden Sie pro Veröffentlichungsversuch einen stabilen Schlüssel, z. B.:
lr-{catalogId}-{photoUuid}-{exportRevision}
Speichern Sie die zurückgegebene media_id am veröffentlichten Foto, damit bei einer erneuten Veröffentlichung zwischen Aktualisierung und neuem Upload gewählt werden kann, sobald PATCH für Medien verfügbar ist.