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