Oxygen News API – részletes dokumentáció

API alap URL: https://oxygen.datalight.hu
Ez az oldal dokumentációs célra készült. A /api/news végpont továbbra is közvetlen JSON feedet ad.

Nyilvános feed: /api/news Admin műveletek tokenhez kötöttek

1) Nyilvános hír feed

GET /api/news

Cél: publikusan lekérhető, rendezett hírlista. A találatok alapból legfrissebb szerint csökkenő sorrendben jönnek.

Query paraméterek

Név	Típus	Leírás	Példa
limit	szám	Hány rekord jöjjön vissza (1..500).	50
offset	szám	Lapozás kezdő indexe.	0
language	szöveg	Nyelvi szűrés ISO nyelvkóddal.	hu
q	szöveg	Keresés címben, tartalomban és forrásnévben.	ukrajna

Válasz mezők (item)

A dokumentáció szándékosan nem tartalmaz source_url mezőleírást.

Mező	Típus	Jelentés
id	szám	Egyedi rekordazonosító.
published_at	dátum-idő	Eredeti publikálási idő (UTC ISO-8601).
created_at	dátum-idő	Rekord létrehozásának ideje az adatbázisban.
updated_at	dátum-idő	Rekord utolsó módosításának ideje.
title	szöveg	Fő cím.
facebook_title	szöveg	Megosztási célú cím (ha eltér).
content	szöveg	Összefoglaló/cikk-törzs.
image	URL	Képfájl elérhetősége (jellemzően R2 public URL).
language	szöveg	Nyelvkód (pl. hu, en, de, ro).
category	szöveg	Fix cikkszintű kategória. Ha nincs jobb találat, értéke kulfold.
source_name	szöveg	Forrás médium neve.

Lehetséges kategóriák: hazank, life-magazin, kalendarium, hazank-kozelet, hazank-gazdasag, hazank-sport, kulfold, jatek, life-zene, life-mozi-film, life-gasztronomia, life-utazas, life-hirességek, kal-a-nap-uzenete, kal-szulinaposok, kal-tortenelmi-esemenyek, kal-unnepnapok, kal-vilagnapok, oxygen-pillanatok

GET https://oxygen.datalight.hu/api/news?limit=20&offset=0&language=hu

2) Ingest és admin végpontok

Ezek belső vagy admin célú végpontok. Többségükhöz Authorization: Bearer <TOKEN> szükséges.

Metódus	Útvonal	Cél	Auth
POST	/api/ingest	Scraper által előkészített hírek fogadása, validálás, deduplikálás, mentés.	INGEST
DELETE	/api/news/:id	Egy konkrét hír törlése.	ADMIN
POST	/api/news/cleanup	Régi hírek törlése nap alapú szabállyal.	ADMIN
GET	/api/config	Aktuális scraper beállítások lekérdezése.	ADMIN vagy INGEST
PUT	/api/config	Scraper beállítások frissítése (ütemezés, retention, stb.).	ADMIN
POST	/api/scraper/run	Kézi futás indításának jelzése (token alapú trigger).	ADMIN
GET	/api/sites	Forrás oldalak listázása.	ADMIN vagy INGEST
POST	/api/sites	Új forrás oldal felvétele.	ADMIN
PUT	/api/sites/:id	Forrás oldal módosítása.	ADMIN
DELETE	/api/sites/:id	Forrás oldal törlése.	ADMIN
GET	/api/metrics	Ingest statisztikák és operatív metrikák lekérdezése.	ADMIN vagy INGEST
GET	/api/audit	Admin audit napló lekérdezése.	ADMIN vagy INGEST
GET	/api/health	Egyszerű egészségügyi státusz (monitoring célra).	nem kell

3) Hibakódok röviden

HTTP	Jelentés	Tipikus ok
400	Hibás kérés	Hiányzó vagy érvénytelen JSON / paraméter.
401	Nincs jogosultság	Hiányzó vagy hibás Bearer token.
404	Nincs ilyen végpont/elem	Rossz útvonal vagy nem létező azonosító.
409	Ütközés	Duplikált forrás URL a site listában.
429	Túl sok kérés	Nyilvános news rate limit túllépés.
500	Belső hiba	Adatbázis vagy futásidejű hiba.