blob: 9230a9d318119fd9a45d12818955610f7ad73312 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
# Captura
Bring your own backend screen recorder
## Bring Your Own Backend (Protocol version 1.0)
Captura allows you to define a URL that will be used to POST the recording.
### The Request
A `POST` will be made to the request, with the payload containing the binary
contents of the file. You can expect the following headers:
* `User-Agent`: `Captura/1.0`
* `Content-Type`: `video/mp4` or `image/gif`, depending on the output format
selected.
### Authentication / Authorization
We will only do a POST request, so if you need any type of keys or user
identifiers, include them in the URL itself (eg. via path elements or
in the query parameters)
### Expected Response
If the upload is successful, the response *MUST* be a JSON object containing
a key called `url` with a value of type `string` corresponding to the URL
where the file is available. The status code *MUST* be 201 Created.
Any response code other than 201 Created will be treated as an error. Captura
will not re-attempt an upload.
|
