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.

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-09-30T22:29:33.341+00:00",
  "ma" : [ {
    "name" : "Malvin",
    "url" : "https://www.nevinfo.hu/malvin-nevnap-es-jelentes"
  }, {
    "name" : "Teréz",
    "url" : "https://www.nevinfo.hu/terez-nevnap-es-jelentes"
  } ]
}

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

{
  "time" : "2026-09-30T22:29:33.361+00:00",
  "tegnap" : [ {
    "name" : "Becse",
    "url" : "https://www.nevinfo.hu/becse-nevnap-es-jelentes"
  }, {
    "name" : "Jeromos",
    "url" : "https://www.nevinfo.hu/jeromos-nevnap-es-jelentes"
  } ],
  "ma" : [ {
    "name" : "Malvin",
    "url" : "https://www.nevinfo.hu/malvin-nevnap-es-jelentes"
  }, {
    "name" : "Teréz",
    "url" : "https://www.nevinfo.hu/terez-nevnap-es-jelentes"
  } ],
  "holnap" : [ {
    "name" : "Örs",
    "url" : "https://www.nevinfo.hu/ors-nevnap-es-jelentes"
  }, {
    "name" : "Petra",
    "url" : "https://www.nevinfo.hu/petra-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.