Névnap API

Az alábbi JSON végpontokon keresztül saját alkalmazásában vagy weboldalán is megjelenítheti a naprakész névnapi információkat. A szolgáltatás ingyenes, regisztráció nélkül használható. Kérjük, a fair használat érdekében gyorsítótárazza a letöltött adatokat (lásd lentebb), és ne terhelje feleslegesen a szervert.

Végpontok

Alapcím: https://www.nevinfo.hu. A végpontok GET kéréssel hívhatók, válaszuk application/json. A végpontok CORS-t engedélyeznek, ezért JavaScriptből, böngészőből is közvetlenül hívhatók.

Válasz

GET /api/v1/ma – a ma tömb a naphoz tartozó neveket tartalmazza (name és a név oldalára mutató url):

{
  "time": "2026-11-14T23:55:15.801Z",
  "ma": [
    {
      "name": "Albert",
      "url": "https://www.nevinfo.hu/albert-nevnap-es-jelentes"
    },
    {
      "name": "Lipót",
      "url": "https://www.nevinfo.hu/lipot-nevnap-es-jelentes"
    }
  ]
}

GET /api/v1/3nap – a tegnap, ma és holnap tömböket adja vissza, mindegyik ugyanolyan alakú, mint fentebb:

{
  "time": "2026-11-14T23:55:15.809Z",
  "tegnap": [
    {
      "name": "Aliz",
      "url": "https://www.nevinfo.hu/aliz-nevnap-es-jelentes"
    },
    {
      "name": "Vanda",
      "url": "https://www.nevinfo.hu/vanda-nevnap-es-jelentes"
    }
  ],
  "ma": [
    {
      "name": "Albert",
      "url": "https://www.nevinfo.hu/albert-nevnap-es-jelentes"
    },
    {
      "name": "Lipót",
      "url": "https://www.nevinfo.hu/lipot-nevnap-es-jelentes"
    }
  ],
  "holnap": [
    {
      "name": "Margit",
      "url": "https://www.nevinfo.hu/margit-nevnap-es-jelentes"
    },
    {
      "name": "Ödön",
      "url": "https://www.nevinfo.hu/odon-nevnap-es-jelentes"
    }
  ]
}

Példakódok

A /api/v1/ma végpont lekérdezése és kiírása:

curl -s "https://www.nevinfo.hu/api/v1/ma"

import requests

response = requests.get("https://www.nevinfo.hu/api/v1/ma", timeout=10)
response.raise_for_status()
data = response.json()

for name in data["ma"]:
    print(name["name"], name["url"])

const response = await fetch("https://www.nevinfo.hu/api/v1/ma");
if (!response.ok) throw new Error("HTTP " + response.status);

const data = await response.json();
data.ma.forEach(({ name, url }) => console.log(name, url));

type Nameday = { name: string; url: string };
type TodayResponse = { time: string; ma: Nameday[] };

const response = await fetch("https://www.nevinfo.hu/api/v1/ma");
if (!response.ok) throw new Error(`HTTP ${response.status}`);

const data: TodayResponse = await response.json();
data.ma.forEach(({ name, url }) => console.log(name, url));

<?php
$body = file_get_contents("https://www.nevinfo.hu/api/v1/ma");
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);

foreach ($data["ma"] as $name) {
    echo $name["name"], " ", $name["url"], PHP_EOL;
}

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"time"
)

type Nameday struct {
	Name string `json:"name"`
	URL  string `json:"url"`
}

type TodayResponse struct {
	Time string    `json:"time"`
	Ma   []Nameday `json:"ma"`
}

func main() {
	client := &http.Client{Timeout: 10 * time.Second}
	response, err := client.Get("https://www.nevinfo.hu/api/v1/ma")
	if err != nil {
		log.Fatal(err)
	}
	defer response.Body.Close()

	var data TodayResponse
	if err := json.NewDecoder(response.Body).Decode(&data); err != nil {
		log.Fatal(err)
	}

	for _, name := range data.Ma {
		fmt.Println(name.Name, name.URL)
	}
}

Gyorsítótárazás

A névnapi adatok napon belül nem változnak, ezért érdemes a letöltött választ legalább a nap végéig gyorsítótárazni, és csak naponta egyszer lekérdezni. Így az alkalmazása is gyorsabb lesz, és nem terheli feleslegesen a szervert.

Kapcsolat

Nagyobb adatigény, egyedi igény vagy hiba esetén a Kapcsolat menüponton keresztül írhat nekünk.