Spec

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/tip-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/tip-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": "Tip Calculator API",
        "notes": "All maths is done in integer cents to avoid floating-point errors; the shares array always sums exactly to the total, with leftover cents given to the first people. Currency-agnostic — values are plain numbers. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/calc",
                "params": {
                    "bill": "the bill amount (required)",
                    "round": "none (default), up (round total up to a whole unit) or nearest",
                    "people": "split between N people (default 1)",
                    "tip_percent": "tip percentage (default 15)"
                },
                "returns": "the tip, total and per-person amounts"
            },
            {
                "path": "/v1/split",
                "params": {
                    "amount": "the amount to split (required)",
                    "people": "number of people (default 2)",
                    "tip_percent": "optional tip to add first (default 0)"
                },
                "returns": "an exact per-person share list that sums to the total"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Work out tips and split a bill — with exact cent maths, so the per-person amounts always add back up to the total. The calc endpoint takes a bill, a tip percentage (default 15%) and a number of people and returns the tip, the grand total, the per-person amount, the effective tip percent, and an optional rounding of the total (up to the next whole unit, or to the nearest). The split endpoint divides an amount (optionally adding a tip) evenly among people, distributing any leftover cents fairly so a few people pay one cent more rather than the totals being off by a penny. Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:19.087Z",
        "request_id": "91b94a8a-85f8-4577-baee-76489141651d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}