API

Översikt

Ett läs-API för namnsdagar. Alla endpoints returnerar JSON och stöder CORS från alla ursprung. Statiska svar (alla utom /today) CDN-cachas i en vecka; /today cachas fram till nästa midnatt i Europe/Stockholm. Webbläsare revaliderar alltid (max-age=0).

Tillgängliga landskoder: SE, NO, DK, DE, CZ, PL. Om countryCode utelämnas används paketets standard (SE).

Endpoints

• GET/api/v1/today

  Namnsdagar för i dag i den valda tidszonen (Europe/Stockholm).

  https://namnsdag.tammergard.se/api/v1/today?countryCode=SE

• GET/api/v1/all

  Alla namnsdagar för det valda landet.

  https://namnsdag.tammergard.se/api/v1/all?countryCode=SE

• GET/api/v1/on/{month}/{day}

  Namnsdagar för ett specifikt datum.

  https://namnsdag.tammergard.se/api/v1/on/5/21?countryCode=SE

• GET/api/v1/when/{name}

  Datum då ett givet namn har namnsdag.

  https://namnsdag.tammergard.se/api/v1/when/Anna?countryCode=SE

• GET/api/v1/where/{countryCode}

  Alla namnsdagar för ett land (samma som /all men i sökväg).

  https://namnsdag.tammergard.se/api/v1/where/SE

• GET/api/v1/who/{id}

  Hämta en enskild namnsdag via dess id.

  https://namnsdag.tammergard.se/api/v1/who/SE-5-21-1

Svarsformat

Alla endpoints (utom /who/{id}) returnerar en lista av namnsdagsobjekt:

{
  "id": "SE-5-21-1",
  "countryCode": "SE",
  "name": "Conny",
  "month": 5,
  "day": 21
}

Fel

Fel returneras som JSON. Statuskoder:

• 400 – saknad eller felformaterad parameter (t.ex. /on/abc/1)
• 422 – giltig form men ogiltigt värde (t.ex. month=13 eller okänd landskod)
• 404 – resurs saknas (gäller /who/{id})

{
  "error": {
    "status": 422,
    "message": "Invalid countryCode \"XX\". Must be one of: SE, NO, DK, DE, CZ, PL."
  }
}

Källkod

API:et bygger på namedays-paketet på npm.