updated documentation

This commit is contained in:
bill bittner 2017-10-05 15:37:20 -07:00
parent be0bf27a14
commit b198a35a9b

View file

@ -28,28 +28,24 @@ spee.ch is a single-serving site that reads and publishes images and videos to a
#### GET #### GET
* /api/resolve/:name * /api/resolve/:name
* a successfull request returns the resolve results for the claim at that name in JSON format * example: `curl https://spee.ch/api/resolve/doitlive`
* /api/claim_list/:name * /api/claim_list/:name
* a successfull request returns a list of claims at that claim name in JSON format * example: `curl https://spee.ch/api/claim_list/doitlive`
* /api/isClaimAvailable/:name * /api/isClaimAvailable/:name (returns `true`/`false` for whether a name is available through spee.ch)
* a successfull request returns a boolean: `true` if the name is still available, `false` if the name has already been published to by spee.ch. * example: `curl https://spee.ch/api/isClaimAvailable/doitlive`
#### POST #### POST
* /api/publish * /api/publish
* request parameters: * example: `curl -X POST -F 'name=MyPictureName' -F 'nsfw=false' -F 'file=@/path/to/my/picture.jpeg' https://spee.ch/api/publish`
* body (form-data): * Parameters:
* name: string (optional) * name (string)
* defaults to the file's name, sans extension * nsfw (boolean)
* names can only contain the following characters: `A-Z`, `a-z`, `_`, or `-` * file (.mp4, .jpeg, .jpg, .gif, or .png)
* license: string (optional) * license (string, optional)
* defaults to "No License Provided" * title (string, optional)
* only "Public Domain" or "Creative Commons" licenses are allowed * description (string, optional)
* nsfw: string, number, or boolean (optional) * channelName(string, optional)
* defaults `true` * channelPassword (string, optional)
* nsfw can be a string ("on"/"off"), number (0 or 1), or boolean (`true`/`false`)
* files:
* the `files` object submitted must use "speech" or "null" as the key for the file's value object
* a successfull request will return the transaction details resulting from your published claim in JSON format
## bugs ## bugs
If you find a bug or experience a problem, please report your issue here on github and find us in the lbry slack! If you find a bug or experience a problem, please report your issue here on github and find us in the lbry slack!