help:api write requests
These are API requests which use the HTTP POST, PUT/PATCH or DELETE methods.
Limit
These types of requests are rate-limited per user level (Help:Users). Burst writes is just where the available API writes caps off at. Regen rate is just how quickly the available writes get replaced after use.
| Member levels | Burst writes | Regen rate |
|---|---|---|
| Member | 10 API writes | 1 write/sec |
| Gold | 30 API writes | 2 write/sec |
| Platinum+ | 60 API writes | 4 write/sec |
Parameters
The parameters for write requests must be passed along in the body instead of as part of the URL.
URL encoding
These parameters use URL hash encoding (Help:Hash format), where the base object is the singular name of the endpoint.
- Content-Type:
application/x-www-form-urlencoded - Format: OBJECT[PARAMETER]=VALUE
- Example:
post[rating]=s&post[tag_string]=danboo
JSON encoding
These parameters use JSON hash encoding [1], where the base object is also the singular name of the endpoint.
- Content-Type:
application/json - Format: { "OBJECT": { "PARAMETER": VALUE } }
- Example:
{ "post": { "rating": "s", "tag_string": "danboo" } }
Using POST for method override
The POST method can be used to send data to endpoints that require other methods, in such cases where only one method is available, for instance <form> HTML elements.
URL encoding
PUT/PATCH and DELETE methods can also be sent by setting the parameter _method with the name of the method as its value.
JSON encoding
PUT/PATCH and DELETE methods can also be sent by setting the X-HTTP-Method-Override header with the name of the method as its value.