🚥
New Pixela Supporter Benefit! (Pixela v1.25.0)
Posted date
2022/7/25
Tags
Release
(Added 2022-07-31) Some of the specifications additions made by this release have been changed and the changes are being released as v1.25.1. For more details, please check here.
The following new specification have been added with this release of Pixela v1.25.0 .
- For some APIs, requests for those APIs are rejected 25% of the time.
- The HTTP status code and HTTP response body for a rejected request are as follows:
- HTTP status code
503 Service Unavailable
- HTTP response body
{"message":"Please retry this request. Your request for some APIs will be rejected 25% of the time because you are not a Pixela supporter. If you are interested in being a Pixela supporter, please see: https://github.com/a-know/Pixela/wiki/How-to-support-Pixela-by-Patreon-/-Use-Limited-Features","isSuccess":false,"isRejected":true}
The target APIs to which this specification applies is not public.(2022-07-26 added) The target API is now open to the public. The following is the target.- User
DELETE - /v1/users/<username>
- User profile
PUT /@<username> - Update user profile
- Graph
GET /v1/users/<username>/graphs - Get graph definitions
GET /v1/users/<username>/graphs/<graphID>/graph-def - Get a graph definition
PUT /v1/users/<username>/graphs/<graphID> - Update a graph
DELETE /v1/users/<username>/graphs/<graphID> - Delete a graph
GET /v1/users/<username>/graphs/<graphID>/pixels - Get graph pixels list
- Pixel
POST /v1/users/<username>/graphs/<graphID> - Post a pixel
GET /v1/users/<username>/graphs/<graphID>/<yyyyMMdd> - Get a pixel
PUT /v1/users/<username>/graphs/<graphID>/<yyyyMMdd> - Update a pixel
DELETE /v1/users/<username>/graphs/<graphID>/<yyyyMMdd> - Delete a pixel
- Instant recording
PUT /v1/users/<username>/graphs/<graphID>/increment - Increment a pixel
PUT /v1/users/<username>/graphs/<graphID>/decrement - Decrement a pixel
POST /v1/users/<username>/graphs/<graphID>/stopwatch - Measuring and recording time
- Webhook
POST /v1/users/<username>/webhooks - Create a webhook
GET /v1/users/<username>/webhooks - Get webhooks
DELETE /v1/users/<username>/webhooks/<webhookHash> - Delete a webhook
- These specifications are subject to change without notice. If any changes are made, we will notify users in the way of a new version release.
List of Target APIs
The above specification do not apply to API requests for Pixela supporter users. In other words, this is a new Pixela supporter benefit that has been added this time.
Error responses returned by this specification are retriable error.If you are not a Pixela supporter, please handle the above error correctly and retry appropriately.
(Even for Pixela supporters, errors such as HTTP status code
503
can occur at any time due to server errors or service failures. Therefore, there is no better time to implement such error handling.)We understand that the addition of this specification is both challenging and ambitious. If you have any comments on this specification addition, please let us know on GitHub issues! (Pixela users are all over the world, so please give us your comments in English!)
Well then, enjoy Pixela v1.25.0!