API
Client
To simplify uploading and deleting files, you can use linx-client, which uses this API.
Keys
This instance uses API Keys, therefore you will need to provide a key for uploading and deleting
files.
To do so, add the Linx-Api-Key
header with your key.
Uploading a file
To upload a file, make a PUT request to https://o.perezdecastro.org/upload/
and you will get the url of
your upload back.
Optional headers with the request
Randomize the filename
Linx-Randomize: yes
Specify a custom deletion key
Linx-Delete-Key: mysecret
Protect file with password
Linx-Access-Key: mysecret
Specify an expiration time (in seconds)
Linx-Expiry: 60
Get a json response
Accept: application/json
The json response will then contain:
“url”: the publicly available upload url
“direct_url”: the url to access the file directly
“filename”: the (optionally generated) filename
“delete_key”: the (optionally generated) deletion key,
“access_key”: the (optionally supplied) access key,
“expiry”: the unix timestamp at which the file will expire (0 if never)
“size”: the size in bytes of the file
“mimetype”: the guessed mimetype of the file
“sha256sum”: the sha256sum of the file,
Examples
Uploading myphoto.jpg
$ curl -H "Linx-Api-Key: mysecretkey" -T myphoto.jpg https://o.perezdecastro.org/upload/
https://o.perezdecastro.org/myphoto.jpg
Uploading myphoto.jpg with an expiry of 20 minutes
$ curl -H "Linx-Api-Key: mysecretkey" -H "Linx-Expiry: 1200" -T myphoto.jpg https://o.perezdecastro.org/upload/
https://o.perezdecastro.org/myphoto.jpg
Uploading myphoto.jpg with a random filename and getting a json response:
$ curl -H "Linx-Api-Key: mysecretkey" -H "Accept: application/json" -H "Linx-Randomize: yes" -T myphoto.jpg https://o.perezdecastro.org/upload/
{"delete_key":"...","expiry":"0","filename":"f34h4iu.jpg","mimetype":"image/jpeg",
"sha256sum":"...","size":"...","url":"https://o.perezdecastro.org/f34h4iu.jpg"}
Overwriting a file
To overwrite a file you uploaded, simply provide the Linx-Delete-Key
header with the
original file's deletion key.
Example
To overwrite myphoto.jpg
$ curl -H "Linx-Api-Key: mysecretkey" -H "Linx-Delete-Key: mysecret" -T myphoto.jpg https://o.perezdecastro.org/upload/
https://o.perezdecastro.org/myphoto.jpg
Deleting a file
To delete a file you uploaded, make a DELETE request to https://o.perezdecastro.org/yourfile.ext
with the
delete key set as the Linx-Delete-Key
header.
Example
To delete myphoto.jpg
$ curl -H "Linx-Api-Key: mysecretkey" -H "Linx-Delete-Key: mysecret" -X DELETE https://o.perezdecastro.org/myphoto.jpg
DELETED
Information about a file
To retrieve information about a file, make a GET request the public url with
Accept: application/json
headers and you will receive a json response containing:
“url”: the publicly available upload url
“direct_url”: the url to access the file directly
“filename”: the (optionally generated) filename
“expiry”: the unix timestamp at which the file will expire (0 if never)
“size”: the size in bytes of the file
“mimetype”: the guessed mimetype of the file
“sha256sum”: the sha256sum of the file,
Example
$ curl -H "Accept: application/json" https://o.perezdecastro.org/myphoto.jpg
{"expiry":"0","filename":"myphoto.jpg","mimetype":"image/jpeg","sha256sum":"...","size":"..."}