Kalendāra API

Bezmaksas JSON API tikai lasīšanai: vārda dienas, svētku dienas, karoga dienas, Mēness fāze un nedēļu numuri. Bez atslēgas un bez reģistrācijas. API atbild ar tā kalendāra datiem, kura adresei jūs to izsaucat.

https://latviesukalendars.app/api/v1

Galapunkti

GET /api/v1/today
Viss par šodienu.
GET /api/v1/date/2026-12-06
Konkrēts datums formātā GGGG-MM-DD.
GET /api/v1/name-day/Anna
Kad vārds svin vārda dienu, šogad un nākamgad.

Atbildes lauki

date: ISO datums, GGGG-MM-DD.
weekday: Nedēļas dienas nosaukums vietējā valodā.
weekNumber: Nedēļas numurs pēc ISO 8601, no 1 līdz 53.
nameDay: Vārdi, kas tajā dienā svin vārda dienu.
holidays: Svētku dienas, katrai nosaukums un identifikators.
flagDays: Oficiālās karoga dienas, katrai nosaukums un identifikators.
moon: Mēness fāze un apgaismotās daļas īpatsvars.

Atbildes piemērs

Šī kalendāra tiešā atbilde šodien:

{
  "locale": "lv",
  "date": "2026-11-05",
  "weekday": "Ceturtdiena",
  "weekNumber": 45,
  "nameDay": {
    "names": [
      "Šarlote",
      "Lote"
    ]
  },
  "holidays": [],
  "flagDays": [],
  "moon": {
    "phase": "waningCrescent",
    "illumination": 0.184
  }
}

Pieprasījumu ierobežojums

Līdz 60 pieprasījumiem minūtē no vienas IP adreses. Atbildes tiek kešotas stundu, tāpēc lielākā daļa lietotņu ierobežojumu nekad nesasniedz. Pārsniedzot to, API atgriež kodu 429 un galveni Retry-After.

Noteikumi

Izmantojiet bez maksas lietotnēs, vietnēs un hobija projektos. Saite uz Latviešu kalendārs būs patīkama, bet nav obligāta. Dati var mainīties, tāpēc uztveriet katru atbildi kā mirkļa attēlu.