Styles, notations & locales

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/numberformat-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/numberformat-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": {
        "note": "Format numbers for any locale using the platform's full ICU data. /v1/format?value=1234567.89&style=currency&currency=EUR&locale=de-DE returns the locale-correct string (e.g. 1.234.567,89 €). Styles: decimal, currency (ISO 4217, with currencyDisplay symbol/code/name), percent and unit (e.g. unit=kilometer-per-hour). Options: locale (BCP 47), minimum/maximumFractionDigits, useGrouping, notation (standard, scientific, engineering, compact — e.g. 1.2M), signDisplay. /v1/parts returns the formatToParts breakdown (integer, group, decimal, fraction, currency symbol, …) for building custom-styled displays. Everything is computed locally with no network calls. Ideal for internationalised UIs, invoices and receipts, dashboards, reports and anywhere numbers or money must read correctly per region. A locale number/currency formatter — distinct from foreign-exchange rates (currency), number-to-words (numberwords) and the base converter (baseconvert). No key, no cache.",
        "styles": [
            "decimal",
            "currency",
            "percent",
            "unit"
        ],
        "endpoints": [
            "/v1/format",
            "/v1/parts",
            "/v1/meta"
        ],
        "notations": [
            "standard",
            "scientific",
            "engineering",
            "compact"
        ],
        "example_locales": [
            "en-US",
            "de-DE",
            "fr-FR",
            "ja-JP",
            "ar-EG",
            "hi-IN",
            "pt-BR",
            "zh-CN"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T23:40:41.996Z",
        "request_id": "a1dcf615-cace-465e-9f2f-792358358333"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}