Abuse¶
Abusive apps and users may be reported to Marketplace staff.
Note
Authentication is optional for abuse reports.
Note
These endpoints are rate-limited at 30 requests per hour per user.
Report An Abusive App¶
- POST /api/v1/abuse/app/¶
Report an abusive app to Marketplace staff.
Request
Parameters: - text (string) – a textual description of the abuse
- app (int|string) – the app id or slug of the app being reported
{ "sprout": "potato", "text": "There is a problem with this app.", "app": 2 }
This endpoint uses PotatoCaptcha, so there must be a field named sprout with the value potato and cannot be a field named tuber with a truthy value.
Response
{ "reporter": null, "text": "There is a problem with this app.", "app": { "id": 2, "name": "cvan's app", "...": "more info" } }
Status Codes: - 201 – successfully submitted.
- 400 – submission error.
- 429 – exceeded rate limit.
Report An Abusive User¶
- POST /api/v1/abuse/user/¶
Report an abusive user to Marketplace staff.
Request
Parameters: - text (string) – a textual description of the abuse
- user (int) – the primary key of the user being reported
{ "sprout": "potato", "text": "There is a problem with this user", "user": 27 }
This endpoint uses PotatoCaptcha, so there must be a field named sprout with the value potato and cannot be a field named tuber with a truthy value.
Response
{ "reporter": null, "text": "There is a problem with this user.", "user": { "display_name": "cvan", "resource_uri": "/api/v1/account/settings/27/" } }
Status Codes: - 201 – successfully submitted.
- 400 – submission error.
- 429 – exceeded rate limit.