Service metadata

Frammenti di codice

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

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

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

Risposta di esempio

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

{
    "data": {
        "service": "flags-api",
        "endpoints": {
            "GET /v1/flag": "Flag by country (country=, e.g. Germany) or ISO code (code=, e.g. de).",
            "GET /v1/list": "List all flags (limit, offset).",
            "GET /v1/meta": "This document.",
            "GET /v1/filter": "Filter flags by color=, mainhue= or symbol= (crescent, star, cross, saltire, circle, triangle, quarter, text, icon, animate).",
            "GET /v1/search": "Search flags by country name or code (q=, min 2 chars)."
        },
        "description": "National flag design (UCI Flags dataset, 194 countries) enriched with ISO 3166-1 alpha-2 code, Unicode flag emoji and SVG/PNG image URLs. Exposes each flag's bars, stripes, colours, main hue, corner colours and symbols (stars, crescent, cross, saltire, circle, triangle, icon, animate, text). Look up by country or code, search, or filter by colour / main hue / symbol. No key.",
        "total_flags": 194
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:10.442Z",
        "request_id": "50d599f6-c2de-45e2-bb84-9e3e5076e73d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}