API-Schlüssel und Integrationen
Erstellen Sie Zugangsdaten mit den Berechtigungen, die Ihre Werkzeuge benötigen.
Anleitungen für den Einstieg
Entwickeln Sie Anwendungen und automatisieren Sie Dateiabläufe in dosya. Die Anleitungen behandeln API-Schlüssel, Authentifizierung, REST-Anfragen, Uploads, Downloads, Freigabelinks, Webhooks, Anfragelimits, Fehler und den sicheren Umgang mit Zugangsdaten. Jeder Abschnitt erklärt die nötigen Einstellungen und Prüfungen für eine zuverlässige Integration. Beginnen Sie mit dem REST-API-Schnellstart, erstellen Sie einen API-Schlüssel mit eng begrenzten Berechtigungen und ergänzen Sie Webhooks, wenn Ihr System auf Dateiaktivitäten reagieren soll.
- Einen API-Upload abschließen und prüfen Laden Sie alle Multipart-Teile hoch und schließen Sie die Sitzung einmal ab. Klären Sie verlorene Antworten über den Status und prüfen Sie den gelieferten Dateidatensatz sicher.
- Einen Ordner per REST-API erstellen und den Elternordner prüfen Erstellen Sie per REST API einen Ordner. Ordnen Sie wiederverwendete Pfadsegmente richtig ein und prüfen Sie, ob der gelieferte Unterordner unter dem gewünschten Elternordner liegt.
- Eine REST-API-Uploadsitzung erstellen Starten Sie einen REST-API-Upload mit richtigem Ziel, Größe, Berechtigung und Multipart-Einstellung. Prüfen Sie die gelieferte Sitzung, bevor Sie Bytes senden.
- Eine Datei über die REST-API herunterladen Holen Sie eine signierte REST-Download-URL mit gewählter Gültigkeit oder Dateiversion. Laden und prüfen Sie Bytes. Klären Sie Sperren, Berechtigungen und Nutzungsablehnungen.
- REST-API-Fehler und Seiten behandeln Verarbeiten Sie Dateiseiten ohne Auslassungen. Ordnen Sie dosya-API-Fehler nach Status und Antwortinhalt ein und wiederholen Sie nur sicher wiederholbare Aktionen.
- Nicht verfügbare von verweigerten API-Dateien unterscheiden Deuten Sie 404- und 403-Antworten zu Dateien richtig, ohne fremde Kennungen zu testen, verborgene Ressourcen offenzulegen oder fehlende Berechtigungen als Löschung zu verstehen.
- Ordner über die REST-API erstellen und verschieben Erstellen, benennen und verschieben Sie Ordner über die jeweiligen REST-Endpunkte. Prüfen Sie den endgültigen Elternordner, behalten Sie die Namen bei und vermeiden Sie Konflikte im Ordnerbaum.
- Dateimetadaten anhand der Datei-ID per API abrufen Rufen Sie eine Datei anhand ihrer ID ab. Prüfen Sie Metadatenfelder und null-Werte und unterscheiden Sie fehlende, verborgene, gesperrte und verweigerte Dateien.
- Einen API-Schlüssel erstellen und verwalten Erstellen Sie im Profil einen API-Schlüssel mit passenden Berechtigungen und Grenzen. Sichern Sie den einmalig gezeigten Wert. Ersetzen oder widerrufen Sie ihn später.
- Einen API-Schlüssel vor Ende seiner Gültigkeit ersetzen Ersetzen Sie einen bald ungültigen API-Schlüssel ohne Unterbrechung. Übernehmen Sie Einstellungen, setzen Sie fehlende Limits und Gültigkeit erneut und testen Sie den Ersatz vor dem Widerruf.