Svenska namnsdagar API

Hämta all namnsdagsinformation

Utan query-parametrar i URL kan man hämta en JSON med all namnsdagsinformation.

https://damberg.one/blogg/2024/namnsdagar/api.php

Anropet ovar returnerar JSON-formatterad information om alla namnsdagar.



Hämta dagens namnsdagsnamn

Med query-parametern today hämtas dagens namn.

https://damberg.one/blogg/2024/namnsdagar/api.php?today

Anropet ovan returnerar en kommaseparerad lista på dagens namnsdagsnamn.



Med query-parameter name

Om man lägger till en query-parameter för name kan man söka på namn och få tillbaka information om den bästa matchens dags namnsdagar.

https://damberg.one/blogg/2024/namnsdagar/api.php?name=anders

Sökstrategi

Sökordningen är baserad på kriterier och första matchen i sökstrategin returneras:

  1. Om en exakt match hittas returneras den dagens informationspost
  2. För att hantera dubbelnamn görs en slagning på ensklida namn separerade av bindestreck och med mellanslag vars första eventuella förekomst returneras
  3. En sökning genomförs för partiella namn (string contains)
  4. Bästa match beräknas med hjälp av dess Levenshteinska distans (och HTTP-response får HTTP-status 404)

Sökresultatets queryStatus

Vid sökning med namn läggs fältet queryStatus till på posten baserat på i vilken av sökstrategierna ovan en match gjordes. Denna queryStatus kan ha följande värden:



Hämta namn för visst datum

Med query-paramtrarna month och day hämtas en kommaseparerad lista över namnen detta datum.

https://damberg.one/blogg/2024/namnsdagar/api.php?month=4&day=12

Ordningen på query-parametrar är inte viktig, men de är skiftlägeskänsliga.