api:file:auth
Table of Contents
API : File Auth
Introduction
This request is called by the file servers to validate whether a file may be served to the requesting client. It is not intended for direct integrator use, but it is publicly reachable and can be called without logging in.
Request
| URL | https://api.telecomx.dk/file/FILE_ID/auth | |
|---|---|---|
| Method | GET | |
| Access level | None - no login required. The token in the query decides the answer. | |
| Param | FILE_ID | The file's fileId as known by the file server (24 hex-char string). Note: this is NOT the document id used by the other /file endpoints. |
| Query | token | [optional] Employee token or IPTV device token authorising the access. Not needed for public (ALL-level) files. |
Query example
https://api.telecomx.dk/file/1234567890ABCDEF12345678/auth?token=<TOKEN>
Response
| Json object | ||
|---|---|---|
| access | Boolean | True when the file may be served to the client. |
Example
{ "access": true }
Errors
| Error code | Message | Description |
|---|---|---|
| 422 | id | File id is invalid |
| 404 | not_found | No file with that fileId |
| 403 | access_denied | Token is missing, invalid or does not grant access to the file |
| 500 | internal_error | <Unspecified> |
api/file/auth.txt · Last modified: by Mikkel Meerwaldt Jørgensen