Spec

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/name-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/name-api/v1/meta",
    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": {
        "name": "Name API",
        "notes": "Parsing is heuristic and tuned for Western name order (given name first). Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/case",
                "params": {
                    "name": "a name (required)"
                },
                "returns": "the properly-cased name"
            },
            {
                "path": "/v1/parse",
                "params": {
                    "name": "a full name (required)"
                },
                "returns": "salutation, first/middle/last name, suffix + a cased version"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Proper-case and parse personal names — correctly handles McDonald, MacLeod, O'Brien, hyphenated names, particles (van, von, de, la) and suffixes (Jr., III). Powered by namecase + humanparser. Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-02T16:51:47.065Z",
        "request_id": "3808c22a-8f0d-4119-975d-b3ceb69b0b81"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}