API keys and integrations
Create credentials with the access your tools need.
Start with these guides
Build applications and automations that work with files in Dosya. These guides cover API keys, authentication, REST requests, uploads, downloads, sharing links, webhooks, rate limits, errors, and safe credential handling. Each topic focuses on the controls and checks needed for a reliable integration. Begin with the REST API quickstart, create a narrowly scoped key, and add webhooks when your system needs to react to file activity.
- Complete and verify an API upload Upload every multipart segment, complete the session once, recover a lost response through status, and confirm the returned file record safely.
- Create an API folder and verify its parent Create one folder through the REST API, interpret reused path segments correctly, and verify the returned child beneath the intended parent folder.
- Create a REST API upload session Start a REST API upload with the correct destination, size, scope, and multipart settings, then inspect the returned session before sending bytes.
- Download a file with the REST API Obtain a signed REST download URL, choose its lifetime or file version, fetch and verify bytes, and resolve locks, permissions and usage failures.
- Handle REST API errors and pagination Process page-number results without skipping files, classify Dosya API failures by status and body, and retry only operations that are safe to repeat.
- Distinguish unavailable and unauthorized API files Interpret file 404 and 403 responses without probing unrelated identifiers, leaking a hidden resource, or mistaking a permissions failure for deletion.
- Create and move folders with the REST API Create, rename, and move folders through their exact REST endpoints, then verify the final parent while preserving names and avoiding tree conflicts.
- Fetch file metadata by API identifier Fetch one file record by identifier, interpret every returned metadata field and null value, and separate missing, hidden, locked, and denied responses.
- Creating and managing an API key Generate a key in Profile, choose its permissions and restrictions, save it while it is displayed, and replace or revoke it later.
- Rotate an expiring API key Duplicate an expiring key’s available settings, restore omitted limits and expiry, validate the replacement, then revoke the old secret without downtime.