more readmes

rtfm/API.md

@@ -0,0 +1,55 @@
+# 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
+
+```
+{
+    "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
+
+```
+{
+    "status":"err",
+    "reason":"Unsupported filetype"
+}
+```
+
+### Example
+
+Uploading a file called test.jpg via curl
+
+```curl -F "file=@test.jpg" https://pictshare.net/api/upload.php```
+
+Answer from the server:
+```{"status":"ok","hash":"y1b6hr.jpg","url":"https://pictshare.net/y1b6hr.jpg"}```
+
+---
+
+## 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"
+
+```url -F "api_paste_code=Hello World" https://pictshare.net/api/pastebin.php```
+
+Answer from the server:
+```https://pictshare.net/vekjy4e5rr.txt```