Vai al contenuto
GET /v1/random

A random page of wallpapers for discovery

Provalo dal vivo

10 chiamate gratuite al giorno — senza registrazione, senza chiave API. Passa dal gateway oanor.

Intestazioni personalizzate (facoltative)
api.oanor.com/wallhaven-api

Funziona. Prendi una chiave API e usala nel tuo progetto.

Ottieni una chiave API

Frammenti di codice

curl "https://api.oanor.com/wallhaven-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/wallhaven-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/wallhaven-api/v1/random");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/wallhaven-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "page": 1,
        "seed": "YxxEpb",
        "count": 24,
        "category": "all",
        "wallpapers": [
            {
                "id": "y8kjxk",
                "url": "https://wallhaven.cc/w/y8kjxk",
                "image": "https://w.wallhaven.cc/full/y8/wallhaven-y8kjxk.jpg",
                "ratio": "1.78",
                "thumb": "https://th.wallhaven.cc/small/y8/y8kjxk.jpg",
                "views": 4065,
                "colors": [
                    "#000000",
                    "#424153",
                    "#996633",
                    "#663399",
                    "#cc6633"
                ],
                "purity": "sfw",
                "category": "general",
                "favorites": 55,
                "file_size": 431500,
                "file_type": "image/jpeg",
                "resolution": "1920x1080"
            },
            {
                "id": "4d3ml3",
                "url": "https://wallhaven.cc/w/4d3ml3",
                "image": "https://w.wallhaven.cc/full/4d/wallhaven-4d3ml3.jpg",
                "ratio": "1.6",
                "thumb": "https://th.wallhaven.cc/small/4d/4d3ml3.jpg",
                "views": 3489,
                "colors": [
                    "#000000",
                    "#e7d8b1",
                    "#424153",
                    "#999999",
                    "#ffffff"
                ],
                "purity": "sfw",
                "category": "general",
                "favorites": 8,
                "file_size": 212928,
                "file_type": "image/jpeg",
                "resolution": "1440x900"
            },
            {
                "id": "yjl39k",
                "url": "https://wallhaven.cc/w/yjl39k",
                "image": "https://w.wallhaven.cc/full/yj/wallhaven-yjl39k.jpg",
                "ratio": "1.78",
                "thumb": "https://th.wallhaven.cc/small/yj/yjl39k.jpg",
                "views": 8251,
                "colors": [
                    "#999999",
                    "#424153",
                    "#cccccc",
                    "#ffffff",
                    "#996633"
                ],
                "purity": "sfw",
                "category": "anime",
                "favorites": 45,
                "file_size": 413355,
                "file_type": "image/jpeg",
                "resolution": "1920x1080"
            },
            {
                "id": "kwjg31",
                "url": "https://wallhaven.cc/w/kwjg31",
                "image": "https://w.wallhaven.cc/full/kw/wallhaven-kwjg31.jpg",
                "ratio": "0.67",
                "thumb": "https://th.wallhaven.cc/small/kw/kwjg31.jpg",
                "views": 2761,
                "colors": [
                    "#999999",
                    "#424153",
                    "#cccccc",
                    "#996633",
                    "#000000"
                ],
                "purity": "sfw",
                "category": "people",
…