crappyrules/notehub
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Wording

Browse Source
This commit is contained in:
Christian Müller
2014-02-18 13:59:43 +01:00
parent 3e28dd691e
commit 139ade3263
1 changed files with 11 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
API.md
+4 -4
View File
@@ -1,4 +1,3 @@
# NoteHub API # NoteHub API
**Version 1.3, status: released.** **Version 1.3, status: released.**
@@ -72,7 +71,7 @@ Parameter | Explanation | Type
`note` | Text to publish | **required** `note` | Text to publish | **required**
`pid` | Publisher ID | **required** `pid` | Publisher ID | **required**
`signature` | Signature | **required** `signature` | Signature | **required**
`password` | MD5 hash of a plain password for editing | *optional* `password` | Secret token (plain or hashed) | *optional*
`version` | Used API version | **required** `version` | Used API version | **required**
`theme` | Theme name | *optional* `theme` | Theme name | *optional*
`text-font` | Text font name | *optional* `text-font` | Text font name | *optional*
@@ -82,7 +81,7 @@ The Signature is the MD5 hash of the following string concatenation:
pid + psk + note pid + psk + note
The signature serves as a proof, that the request is authentic and will be issued by the publisher corresponding to the provided PID. The signature serves as a proof, that the request is authentic and will be issued by the publisher corresponding to the provided PID. Please note, that _all_ of the values used in the signature computation, should be identical to the values passed with the request itself.
The parameters specifying the theme name and fonts are optional and only impact the URLs returned back. The parameters specifying the theme name and fonts are optional and only impact the URLs returned back.
@@ -116,13 +115,14 @@ Parameter | Explanation | Type
`note` | New text | **required** `note` | New text | **required**
`pid` | Publisher ID | **required** `pid` | Publisher ID | **required**
`signature` | Signature | **required** `signature` | Signature | **required**
`password` | MD5 hash of the plain password used for publishing| **required** `password` | Secret token (plain or hashed) | **required**
`version` | Used API version | **required** `version` | Used API version | **required**
The Signature is the MD5 hash of the following string concatenation: The Signature is the MD5 hash of the following string concatenation:
pid + psk + noteID + note + password pid + psk + noteID + note + password
Please note, that all of the values used in the signature computation, should be identical to the values passed with the request itself.
The response of the server will contain the fields `longURL`, `shortURL`, `status`. The response of the server will contain the fields `longURL`, `shortURL`, `status`.