A random artwork (with image)

Extraits de code

curl "https://api.oanor.com/clevelandart-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/clevelandart-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/clevelandart-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/clevelandart-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "artwork": {
            "id": 156532,
            "url": "https://clevelandart.org/art/1992.242",
            "type": "Photograph",
            "image": "https://openaccess-cdn.clevelandart.org/1992.242/1992.242_web.jpg",
            "title": "Hell's Half Acre, Prismatic Springs",
            "culture": [
                "America"
            ],
            "creators": [
                "Frank Jay Haynes (American, 1853–1921)"
            ],
            "copyright": null,
            "technique": "albumen print from glass negative",
            "department": "Photography",
            "dimensions": "Image: 44.7 x 54.5 cm (17 5/8 x 21 7/16 in.); Paper: 45 x 55.1 cm (17 11/16 x 21 11/16 in.); Matted: 61 x 76.2 cm (24 x 30 in.)",
            "image_full": "https://openaccess-cdn.clevelandart.org/1992.242/1992.242_full.tif",
            "description": "Frank Jay Haynes was a photographer of life in the American West and the early days of Yellowstone National Park. Arriving in Yellowstone in the 1880s, he accompanied expeditions into the park, serving as official photographer. From canyon bottoms to mountain peaks, Haynes took his cameras to locations where he could capture unique and artistic views. In this photograph, he documented the immense space of the landscape, made particularly apparent by the inclusion of a small figure standing on the cliff at the right.",
            "did_you_know": null,
            "creation_date": "c. late 1880s",
            "accession_number": "1992.242",
            "share_license_status": "CC0"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:44.599Z",
        "request_id": "4bfbc3a9-0b31-4c28-8c0a-74cf36d8a9cf"
    },
    "status": "ok",
    "message": "Random artwork retrieved successfully",
    "success": true
}