forked from GNUsocial/gnu-social
Fix ticket #2860: clarify API doc comments for 'source' parameter's interaction with OAuth on api/statuses/update
This commit is contained in:
parent
a3928e5583
commit
51a756c211
@ -55,7 +55,7 @@
|
|||||||
Yes
|
Yes
|
||||||
|
|
||||||
@param status (Required) The URL-encoded text of the status update.
|
@param status (Required) The URL-encoded text of the status update.
|
||||||
@param source (Optional) The source of the status.
|
@param source (Optional) The source application name, if using HTTP authentication or an anonymous OAuth consumer.
|
||||||
@param in_reply_to_status_id (Optional) The ID of an existing status that the update is in reply to.
|
@param in_reply_to_status_id (Optional) The ID of an existing status that the update is in reply to.
|
||||||
@param lat (Optional) The latitude the status refers to.
|
@param lat (Optional) The latitude the status refers to.
|
||||||
@param long (Optional) The longitude the status refers to.
|
@param long (Optional) The longitude the status refers to.
|
||||||
@ -67,7 +67,7 @@
|
|||||||
@subsection usagenotes Usage notes
|
@subsection usagenotes Usage notes
|
||||||
|
|
||||||
@li The URL pattern is relative to the @ref apiroot.
|
@li The URL pattern is relative to the @ref apiroot.
|
||||||
@li If the @e source parameter is not supplied the source of the status will default to 'api'.
|
@li If the @e source parameter is not supplied the source of the status will default to 'api'. When authenticated via a registered OAuth application, the application's registered name and URL will always override the source parameter.
|
||||||
@li The XML response uses <a href="http://georss.org/Main_Page">GeoRSS</a>
|
@li The XML response uses <a href="http://georss.org/Main_Page">GeoRSS</a>
|
||||||
to encode the latitude and longitude (see example response below <georss:point>).
|
to encode the latitude and longitude (see example response below <georss:point>).
|
||||||
@li Data uploaded via the @e media parameter should be multipart/form-data encoded.
|
@li Data uploaded via the @e media parameter should be multipart/form-data encoded.
|
||||||
|
Loading…
Reference in New Issue
Block a user