pictshare/rtfm/API.md

# API

# upload.php

- URL https://pictshare.net/api/upload.php
- Method: POST file
- Post var name: file
- Answer type: JSON

If the upload was successful answer will look like this

```json
{
    "status":"ok",
    "hash":"y1b6hr.jpg",
    "url":"https://pictshare.net/y1b6hr.jpg"
}
```

If there is an error the server will answer with status:err and a reason

```json
{
    "status":"err",
    "reason":"Unsupported filetype"
}
```

### Examples

1. Uploading a file called test.jpg via curl

```curl -F "file=@test.jpg" https://pictshare.net/api/upload.php```

Answer from the server:
```json
{"status":"ok","hash":"y1b6hr.jpg","url":"https://pictshare.net/y1b6hr.jpg"}
```

2. Uploading from the commandline using alias, requires `jq` package for json response decoding

Put this in your `.bashrc` or `.zshrc`:
```
pict () {
    curl -s -F "file=@${1:--}" https://pictshare.net/api/upload.php | jq -r '.url';
}
```

Usage:
```
$ cat path/to/image.jpg | pict
```

Repsonse:
```
https://pictshare.net/y1b6hr.jpg
```

# geturl.php

- URL https://pictshare.net/api/geturl.php
- Method: GET
- Var name: url
- Answer type: JSON

Upload content by providing a link to the content. If the link points to a website, the HTML of the page is uploaded as a text bin.

```json
{
    "status":"ok",
    "hash":"y1b6hr.jpg",
    "url":"https://pictshare.net/y1b6hr.jpg",
    "delete_code": "aqxqlv3kqokxd15xpkqp8zjljpqerveu",
    "delete_url":   "https://pictshare.net/delete_aqxqlv3kqokxd15xpkqp8zjljpqerveu/2mr2va.txt"
}
```

If there is an error the server will answer with status:err and a reason

```json
{
    "status":"err",
    "reason":"Unsupported filetype"
}
```

### Examples

1. Uploading the HTML of xkcd.com

```curl -s https://pictshare.net/api/geturl.php?url=https://xkcd.com```

Answer from the server:
```json
{
  "status": "ok",
  "hash": "2mr2va.txt",
  "url": "https://pictshare.net/2mr2va.txt",
  "filetype": "text",
  "delete_code": "aqxqlv3kqokxd15xpkqp8zjljpqerveu",
  "delete_url": "https://pictshare.net/delete_aqxqlv3kqokxd15xpkqp8zjljpqerveu/2mr2va.txt"
}
```

2. Uploading a Video from Imgur

```curl https://pictshare.net/api/geturl.php?url=https://i.imgur.com/qQstLQt.mp4```

Answer from the server:

```json
{
  "status": "ok",
  "hash": "u0ni1m.mp4",
  "url": "https://pictshare.net/u0ni1m.mp4",
  "filetype": "mp4",
  "delete_code": "aqxqlv3kqokxd15xpkqp8zjljpqerveu",
  "delete_url": "https://pictshare.net/delete_aqxqlv3kqokxd15xpkqp8zjljpqerveu/u0ni1m.mp4"
}
```

3. Uploading from the commandline using alias, requires `jq` package for json response decoding

Put this in your `.bashrc` or `.zshrc`:
```
pictget () {
    curl -s "hhttps://pictshare.net/api/geturl.php?url=$1" | jq -r '.url';
}
```

Usage:
```
$ pictget https://i.imgur.com/qQstLQt.mp4
```

Repsonse:
```
https://pictshare.net/u0ni1m.mp4
```

---

# pasetebin.php
- URL https://pictshare.net/api/pastebin.php
- Method: POST/GET text
- Post var name: api_paste_code
- Answer: Plaintext URL to pasted bin

This API can be used to directly post text. Server responds with the URL to the bin or with an error message

### Example

Creating a new text bin that ready "Hello World"

```curl -F "api_paste_code=Hello World" https://pictshare.net/api/pastebin.php```

Answer from the server:
```https://pictshare.net/vekjy4e5rr.txt```

# info.php
- URL https://pictshare.net/api/info.php
- Method: POST/GET text
- Query var name: hash
- Answer: JSON

This API will get information about any given hash.

## Example

```curl https://pictshare.net/api/info.php?hash=9k3rbw.mp4```

Answer from the server:

```json
{
  "status": "ok",
  "hash": "9k3rbw.mp4",
  "size_bytes": 2513225,
  "size_interpreted": "2.4 MB",
  "type": "video/mp4",
  "type_interpreted": "mp4"
}
```

# base64.php
- URL https://pictshare.net/api/base64.php
- Method: POST/GET
- Query var name: base64
- Answer: JSON

## Example

Upload local image "test.jpg" to pictshare 

```(echo -n "base64="; echo -n "data:image/jpeg;base64,$(base64 -w 0 test.jpg)") | curl --data @- https://pictshare.net/api/base64.php```

```json
{
  "status": "ok",
  "hash": "lpl119.jpg",
  "url": "https://dev.pictshare.net/lpl119.jpg",
  "filetype": "jpeg",
  "delete_code": "z0e1mdo8szxnauspxp2f080e4wd4ycf2",
  "delete_url": "https://dev.pictshare.net/delete_z0e1mdo8szxnauspxp2f080e4wd4ycf2/lpl119.jpg"
}
```