eVIR tudásbázis

Rendszer → Beállítások → Testreszabott feedek

A feed egy állandó, rövid URL, amely egy kiválasztott testreszabott listát adja vissza előre beállított formátumban (HTML, CSV, XLSX vagy JSON). Arra való, hogy egy külső rendszer — webshop, táblázatkezelő, BI-eszköz, időzített letöltő szkript — mindig ugyanazon a címen érje el a listát, anélkül, hogy a lista funkcióját, a dokop és a param=nosave_list_stat_id paramétereket egyenként össze kellene rakni (ezekről az API oldal ír).

A feed URL felépítése:

https://evir.hu/cegnev/cgi-bin/index.cgi?feed=<Feed azonosító>

A menüpont elérhetősége jogosultsághoz kötött. A feedhez előbb el kell menteni a kívánt testreszabott listát (oszlopok, szűrések, rendezés) a Listák oldalon leírtak szerint.

A lista a már létrehozott feedeket mutatja: név, Feed azonosító (1), a hozzá tartozó testreszabott lista (funkció: listanév alakban) és a kimeneti formátum (Módosító). Új feedet a + gombbal lehet felvenni, egy meglévőt a sorára kattintva lehet módosítani.

1. Név: a feed megnevezése, kötelező és egyedi.
2. Feed azonosító: nem szerkeszthető. Mentéskor a rendszer generálja véletlenszerűen; ez kerül a feed URL-be. Meglévő feed módosításakor nem változik, így a már kiadott URL-ek tovább működnek.
3. Testreszabott lista: melyik elmentett testreszabott listát adja vissza a feed. A legördülő az összes felhasználó összes testreszabott listáját mutatja, funkció: listanév alakban.
4. Módosító: a kimenet formátuma:
   • Teljes lista: HTML lista, lapozás nélkül, az összes sorral,
   • CSV, XLSX, JSON: fájl-, illetve adatexport,
   • üresen hagyva: a szokásos, lapozott HTML lista.
5. Token: nem kötelező. Annak a felhasználónak a tokenje, akinek a nevében a feed fut (létrehozását az API oldal Felhasználó létrehozása része írja le). A hatását a lenti, hozzáférésről szóló rész ismerteti.
6. Felvesz: menti a feedet, és visszatér a listához, ahol az új feed már az azonosítójával együtt látszik.

A feed mindig egy eVIR felhasználó nevében, annak jogosultságaival fut. A felhasználót a token azonosítja, ami kétféleképpen adható meg:

1. Token nélkül mentett feed (ajánlott). A hívónak kell a tokent elküldenie, lehetőleg az X-EVIR-TOKEN HTTP fejlécben (így nem kerül bele a webszerver- és proxynaplókba), vagy szükség esetén az URL-ben:

curl -H "X-EVIR-TOKEN: $EVIR_TOKEN" -o partnerek.csv \
  "https://evir.hu/cegnev/cgi-bin/index.cgi?feed=<Feed azonosító>"

https://evir.hu/cegnev/cgi-bin/index.cgi?feed=<Feed azonosító>&token=<token>

Token nélkül hívva a rendszer a bejelentkező oldalt adja vissza, adatot nem.

2. Tokennel mentett feed. A tárolt token miatt maga a feed URL is elég az adatok eléréséhez, külön hitelesítés nélkül. Ez a megoldás csak akkor javasolt, ha a fogadó rendszer nem tud fejlécet vagy paramétert küldeni — és ilyenkor az URL-t jelszóként kell kezelni: ne kerüljön levélbe, nyilvános helyre, megosztott dokumentumba.

Mindkét esetben érvényes, amit az API oldal leír:

• a tokenhez tartozó felhasználónak joga kell legyen a lista funkciójához, és exportnál a formátumnak megfelelő privilégiumhoz (CSV, XLS, JSON);
• a testreszabott listának publikusnak kell lennie, vagy a tokenhez tartozó felhasználó legyen a tulajdonosa;
• a token a felhasználó nevének vagy jelszavának megváltoztatásakor megváltozik — tokennel mentett feedben ilyenkor a tokent is frissíteni kell.

• A feed a testreszabott lista aktuális beállításait használja: a listában módosított oszlopok és szűrések a feed kimenetében is azonnal megjelennek.
• Ha a testreszabott listát a lista felületén újra elmentik, a rendszer új azonosítóval tárolja el. Ilyenkor a feedet meg kell nyitni, a Testreszabott lista mezőben a listát újra ki kell választani, majd a feedet menteni kell. A feed azonosítója (és így az URL-je) ettől nem változik.

Kapcsolódó oldalak:

• Testreszabott listák
• Listák
• API
• Rendszer