List all demons

GET /v2/demons/

Retrieves a, potentially filtered, list of every demon in the pointercrate database, sorted by id.

Filtering:

The result can be filtered by any of the following fields: name, name_contains, requirement, verifier.id (via verifier_id), publisher.id (via publisher_id), verifier.name (via verifier_name), publisher.name (via publisher.name). To filter by creator, please use GET /players/player_id/ and inspect the relevant fields of the Player object.

Pagination is done via the id field.

Request:

No request data required

Response: 200 OK

Example request:

GET /api/v2/demons/
Accept: application/json

List ranked demons

GET /v2/demons/listed/

Retrieves a, potentially filtered, list of only the demons currently placed on the demonslist, sorted by position. The Demon objects returned here will never have their position field be null.

Filtering:

The result can be filtered by any of the following fields: name, name_contains, requirement, verifier.id (via verifier_id), publisher.id (via publisher_id), verifier.name (via verifier_name), publisher.name (via publisher.name). To filter by creator, please use GET /players/player_id/ and inspect the relevant fields of the Player object.

Pagination is done via the position field.

Request:

No request data required

Response: 200 OK

Example request:

GET /api/v2/demons/listed/
Accept: application/json

Adding demons

POST /api/v2/demons/

Adds a demon to the demonlist. Adding a demon automatically shifts the other demons around to make room for the newly added one.

The video value, if provided, must meet the requirements specified here.

Request:

Response: 201 CREATED

Errors:

Example request:

POST /api/v2/demons/
Accept: application/json
Authorization: Bearer <omitted>
Content-Type: application/json

{
    "name": "Cadrega City",
    "position": 11,
    "requirement": 54,
    "verifier": "Sunix",
    "publisher": "Pennutoh",
    "creators": ["Pennutoh"],
    "video": "https://www.youtube.com/watch?v=cHEGAqOgddA"
}

Demon retrieval

GET /v2/demons/ id /

Retrieves detailed information about the demon with the given id

Request:

Response: 200 OK

Response: 304 NOT MODIFIED

Returned if the If-None-Match header is set, and the etag for the demon object matches one of the set values.

Errors:

Example request:

GET /api/v2/demons/1/
Accept: application/json

Modifying a demon

PATCH /v2/demons/ id /

Modifies a given demon.

Note that updating the position of a demon will automatically shift around the other demons to ensure position consistency.

The video value, if provided, must meet the requirements specified here.

Request:

Response: 200 OK

Response: 304 NOT MODIFIED

Returned when the PATCH operation did not make any changes.

Errors:

Example request:

PATCH /api/v2/demons/1/
Accept: application/json
Authorization: Bearer <omitted>
Content-Type: application/json
If-Match: cPOrB3TM19Ffsm8PAkD2jNqB61A=

{
    "position": 17,
    "requirement": 45
}

Adding creators

POST /v2/demons/ id /creators/

Adds a creator the creator list of the demon with the specified id

Request:

Response: 201 CREATED

Nothing

Errors:

Example request:

POST /api/v2/demons/2/creators/
Accept: application/json
Authorization: Bearer <omitted>
Content-Type: application/json

{
    "creator": "ViPriN"
}

Removing creators

DELETE /v2/demons/ demon_id /creators/ player_id /

Removes the specified player from the creator list of the demon with the specified demon_id.

Request:

Response: 204 NO CONTENT

Nothing

Errors:

Example request:

DELETE /api/v2/demons/2/creators/1/
Accept: application/json
Authorization: Bearer <omitted>