Artists

All actions for the "/artists" endpoint.

Create an artist

POST https://api.lolwallpapers.net/beta/artists

Request Body

Name	Type	Description
name	string	The name of the artist.
links	array	An array of valid URLs that lead to the artist's pages (deviantart, artstation, twitter, etc.)

201 Artist successfully created.

{
    "status": "success",
    "data": {
        "id": "BA7R"
    }
}

400 Validation failed.

403 The user needs to confirm his email address.

Get a list of artists

GET https://api.lolwallpapers.net/beta/artists

Query Parameters

Name	Type	Description
search	string	Search through all artists names.
sort	string	Sort by: - name - wallpapers - views - downloads - created_at (default) - updated_at
order	string	Order by: - asc - desc (default)
limit	number	The amount of artists to display per page. Default: 20 Minimum: 1 Maximum: 50
page	number	The page to display. Default: 1

200 Artists successfully retrieved.

{
    "status": "success",
    "data": [
        {
            "id": "BA7R",
            "name": "John Doe",
            "links": [
                "https://www.deviantart.com/johndoe"
            ],
            "wallpapers": 0,
            "created_by": {
                "id": "Q6lB",
                "display_name": "John Doe"
            },
            "created_at": 1596650119,
            "updated_at": 1596650119
        },
    ]
}

400 Validation failed.

Get an artist

GET https://api.lolwallpapers.net/beta/artists/:id

Path Parameters

Name	Type	Description
id	string	The artist ID.

200 Artist successfully retrieved.

{
    "status": "success",
    "data": {
        "id": "BA7R",
        "name": "John Doe",
        "links": [
            "https://www.deviantart.com/johndoe"
        ],
        "wallpapers": 0,
        "created_by": {
            "id": "Q6lB",
            "display_name": "John Doe"
        },
        "created_at": 1596650119,
        "updated_at": 1596650119
    }
}

404 Artist not found.

Edit an artist

PATCH https://api.lolwallpapers.net/beta/artists/:id

Path Parameters

Name	Type	Description
	string	The artists ID.

Request Body

Name	Type	Description
name	string	The name of the artist.
links	string	An array of valid URLs that lead to the artist's pages (deviantart, artstation, twitter, etc.)

204 Artist successfully updated.

400 Validation failed.

404 Artist not found.