diff options
author | zotlabs <mike@macgirvin.com> | 2016-12-03 12:29:51 -0800 |
---|---|---|
committer | zotlabs <mike@macgirvin.com> | 2016-12-03 12:29:51 -0800 |
commit | 5bedf3618d0108a767d1cef32634c7be4942110f (patch) | |
tree | b66098ea7d3a238fda8c511e2bc8118abebdb867 /doc/api_posting.bb | |
parent | f5f1b9602a381193205d7089516dfbcb2ed2f84b (diff) | |
download | volse-hubzilla-5bedf3618d0108a767d1cef32634c7be4942110f.tar.gz volse-hubzilla-5bedf3618d0108a767d1cef32634c7be4942110f.tar.bz2 volse-hubzilla-5bedf3618d0108a767d1cef32634c7be4942110f.zip |
put all the api related stuff in the api folder
Diffstat (limited to 'doc/api_posting.bb')
-rw-r--r-- | doc/api_posting.bb | 24 |
1 files changed, 0 insertions, 24 deletions
diff --git a/doc/api_posting.bb b/doc/api_posting.bb deleted file mode 100644 index c708ad143..000000000 --- a/doc/api_posting.bb +++ /dev/null @@ -1,24 +0,0 @@ -[b][size=xx-large]Posting to the Matrix via the API[/size][/b] - -The API allows you to post to the red# by HTTP POST request. Below you see an example using the command line tool cURL: - -[code]curl -ssl -u [color=blue]$E-Mail[/color]:[color=blue]$Password[/color] -d "[color=blue]$Parameters[/color]" [url][observer=1][observer.baseurl][/observer][observer=0]example.com[/observer]/api/statuses/update -[/url][/code] -[table][tr][td]$E-Mail:[/td][td]The E-Mail Address you use to login, or the channel nickname (without the hostname)[/td][/tr] -[tr][td]$Password:[/td][td]The Password you use to login[/td][/tr] -[tr][td]$Parameters:[/td][td]That's the interesting part, here you insert the content you want to send using the following parameters:[/td][/tr][/table] - -[ul] -[*]title: the title of the posting -[*]channel: the channel you want to post to (do not use this parameter with HTTP Basic auth) -[*]category: a comma-seperated list of categories for the posting -[*]status: the content of the posting, formatted with BBCode - OR -[*]htmlstatus:the content of the posting, formatted in HTML. -[/ul] - -To post to a specific channel, replace the email address with the channel nickname. If you supply the channel parameter, it has to match the "email", but is superfluous anyway. - -Instead of calling [observer=1][observer.baseurl][/observer][observer=0]example.com[/observer]/api/statuses/update which returns a json (you could also add .json on the end to clarify) output, you can use [observer.baseurl]/api/statuses/update.xml to get an xml formatted return. - -Instead of Basic HTTP Authentification you could also use oAuth. |