Files
Send a file to be shown or saved, send a thumbnail, and issue signed links.
AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
application/json- body
files*array<>What to make links for. An entry that is not well formed is dropped.
The links.
application/json- response
links?By file id, then by use: content, download or thumbnail/<width>. Each is a path to open with GET.
image?By file id: the size and the placeholder of an image file.
denied?array<string>The ids of the files that the caller cannot read, or that do not exist.
curl -X POST "https://platform.example.com/api/file/links" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "files": [ { "id": "FILE_ID", "use": "content" }, { "id": "FILE_ID", "use": "thumbnail", "width": 320 } ]}'{ "links": { "property1": { "property1": "string", "property2": "string" }, "property2": { "property1": "string", "property2": "string" } }, "image": {}, "denied": [ "string" ]}AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
id*stringThe id of the file, 32 hexadecimal characters.
v?stringThe version of the file, from a signed link. A request with v can be cached for a long time.
Range?stringOne range of bytes, such as bytes=0-1023.
If-None-Match?stringThe ETag you have.
If-Range?stringThe ETag that the Range is of.
The bytes.
response?fileapplication/octet-streambinarycurl -X GET "https://platform.example.com/api/file/$FILE_ID/content" \ -H "Authorization: Bearer $TOKEN""string"AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
id*stringThe id of the file, 32 hexadecimal characters.
v?stringThe version of the file.
The headers: Content-Type, Content-Length, ETag and Accept-Ranges.
curl -X HEAD "https://platform.example.com/api/file/$FILE_ID/content" \ -H "Authorization: Bearer $TOKEN"AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
id*stringThe id of the file, 32 hexadecimal characters.
v?stringThe version of the file, from a signed link.
Range?stringOne range of bytes, such as bytes=0-1023.
If-None-Match?stringThe ETag you have.
If-Range?stringThe ETag that the Range is of.
The bytes.
response?fileapplication/octet-streambinarycurl -X GET "https://platform.example.com/api/file/$FILE_ID/download" \ -H "Authorization: Bearer $TOKEN""string"AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
id*stringThe id of the file, 32 hexadecimal characters.
v?stringThe version of the file.
The headers.
curl -X HEAD "https://platform.example.com/api/file/$FILE_ID/download" \ -H "Authorization: Bearer $TOKEN"AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
id*stringThe id of the file, 32 hexadecimal characters.
width*integerThe width in pixels: 160, 320, 640, 1280 or 2048.
16032064012802048v?stringThe version of the file, from a signed link.
The image.
response?fileimage/*binarycurl -X GET "https://platform.example.com/api/file/$FILE_ID/thumbnail/$WIDTH" \ -H "Authorization: Bearer $TOKEN""string"AuthorizationBearer <token>An access token of an OAuth client: Authorization: Bearer <token>.
id*stringThe id of the file, 32 hexadecimal characters.
width*integerThe width in pixels: 160, 320, 640, 1280 or 2048.
16032064012802048v?stringThe version of the file.
The headers.
curl -X HEAD "https://platform.example.com/api/file/$FILE_ID/thumbnail/$WIDTH" \ -H "Authorization: Bearer $TOKEN"