===== Testreszabott feedek =====

>> ''[[evir:rendszer:rendszer|Rendszer]] -> Beállítások -> Testreszabott feedek''

A feed egy **állandó, rövid URL**, amely egy kiválasztott [[evir:rendszer:beallitasok:testreszabott_listak|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 [[evir:rendszer:api:api_altalanos|API]] oldal ír).

A feed URL felépítése:
<code>
https://evir.hu/cegnev/cgi-bin/index.cgi?feed=<Feed azonosító>
</code>

{{fa>info-circle?lg}} A menüpont elérhetősége [[evir:rendszer:felhasznalok:jogosultsagi_rendszer|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 [[evir:alapok:listak|Listák]] oldalon leírtak szerint.

----

==== A feedek listája ====

{{evir:rendszer:beallitasok:testreszabott_feedek_lista.png?700}}

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.

----

==== Feed felvétele, módosítása ====

{{evir:rendszer:beallitasok:testreszabott_feedek_urlap.png?700}}

  - **Név**: a feed megnevezése, kötelező és egyedi.
  - **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.
  - **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.
  - **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.
  - **Token**: nem kötelező. Annak a felhasználónak a tokenje, akinek a nevében a feed fut (létrehozását az [[evir:rendszer:api:api_altalanos|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.
  - **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.

----

==== Hozzáférés: token a feedben vagy a hívásban ====

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:
<code>
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>
</code>
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 [[evir:rendszer:api:api_altalanos|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.

----

==== Tudnivalók ====

  * 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:__
  * [[evir:rendszer:beallitasok:testreszabott_listak|Testreszabott listák]]
  * [[evir:alapok:listak|Listák]]
  * [[evir:rendszer:api:api_altalanos|API]]
  * [[evir:rendszer:rendszer|Rendszer]]