Kösd össze az ERP-d vagy a webshopod

Kulcsot a Beállítások → API-hozzáférés alatt hozhat létre a fiók tulajdonosa. A kulcs afk_… formátumú, és minden kérésben fejlécként utazik:

Authorization: Bearer afk_a1b2c3…    # a saját kulcsod

A kulcsot csak a létrehozáskor látod teljes hosszában — mi kizárólag a lenyomatát (hash) tároljuk. Korlát: 60 hívás/perc kulcsonként; felette 429-es válasz jön Retry-After fejléccel.

Minden végpont a https://arfigyelo.com alatt él, a válaszok JSON-ok, a hibák { "error": "…" } formátumúak, magyarul.

• Sebességkorlát: 60 kérés/perc — az egész szervezetre közösen, nem kulcsonként.
• Legfeljebb 5 aktív API-kulcs szervezetenként; a POST ugyanaz, mint a PUT a /products-on.
• A /offers szűrés nélkül max. 1 000 sort ad; az /alerts limitje 1–500 (alapból 200).
• A felderítés (/discover) napi kerete szervezetenként korlátos; a napi automatikus gyűjtés is pótol.

A legtöbb hazai ERP tud ütemezett CSV-exportot — ennyi elég is. A fájlra ugyanaz az intelligens oszlopfelismerés fut, mint az appbeli importra (magyar fejlécek, ékezetek, eltérő oszlopsorrend: mind oké), tehát az ERP meglévő exportja jellemzően átalakítás nélkül jó:

# éjszakai termék- és ársync egyetlen sorban (cron / Feladatütemező)
curl -X PUT https://arfigyelo.com/api/v1/products \
  -H "Authorization: Bearer $ARFIGYELO_API_KEY" \
  -H "Content-Type: text/csv" \
  --data-binary @termekek.csv

# válasz:
# { "total": 812, "created": 3, "updated": 27, "unchanged": 780,
#   "errors": [], "pending_discovery": 3, "note": "…" }

Üres cella = azt a mezőt nem bántjuk. Meglévő termékeknél (EAN- vagy név-egyezés) csak a küldött mezők frissülnek — az éjszakai sync így pontosan az ármozgásokat írja át, semmi mást.

curl -X PUT https://arfigyelo.com/api/v1/products \
  -H "Authorization: Bearer $ARFIGYELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      { "name": "Sony WH-1000XM5 fejhallgató, fekete",
        "ean": "4548736132566",
        "brand": "Sony",
        "my_price": 94990,
        "cost": 71200 }
    ]
  }'

A mezőnevek magyarul is mehetnek (nev, marka, cikkszam, vonalkod, sajat_ar, beszerzesi_ar, arres_kuszob, map_ar). A kihagyott mező érintetlen marad; JSON-ban a null törli az ár-mezőket (sajat_ar, beszerzesi_ar, arres_kuszob, map_ar) és a márka/cikkszám mezőt. A nev kötelező. A vonalkod API-ból nem törölhető — ez a párosítás alapja: új EAN-t hozzáfűzünk, a régit megtartjuk. Egy kérésben legfeljebb 5 000 tétel.

# hol állok árban? (ERP/BI-be visszatölthető)
curl https://arfigyelo.com/api/v1/standings \
  -H "Authorization: Bearer $ARFIGYELO_API_KEY"

# { "products": [ { "name": "…", "my_price": 94990, "position": "mid",
#     "rank": 3, "competitor_count": 7, "cheapest_price": 89990,
#     "cheapest_seller": "…", "diff_vs_cheapest_pct": 5.6, "margin_pct": 24.5,
#     "margin_below_floor": false, "map_violation_count": 0,
#     "suggestion": { "price": 89490, "reason": "…" } } ] }
# position: cheapest | mid | expensive | unknown

# tegnap óta érkezett riasztások
curl "https://arfigyelo.com/api/v1/alerts?since=2026-07-03T00:00:00Z" \
  -H "Authorization: Bearer $ARFIGYELO_API_KEY"

Az új termékek Árukereső-forrását a napi gyűjtés magától felderíti; ha nem akarsz várni, hívd a POST /api/v1/discover végpontot ismételten, amíg a remaining 0 nem lesz. Az ár-javaslat tájékoztató jellegű — az eszköz soha nem áraz át semmit helyetted.

1. Regisztrálj (a 14 napos próba alatt az API is jár), vagy lépj be a fiókodba.
2. Beállítások → API-hozzáférés: hozz létre egy kulcsot, és mentsd el — csak egyszer látod.
3. Küldd fel a katalógusod a fenti CSV- vagy JSON-hívással, és kész.

Kérdésed van, vagy egy konkrét ERP-vel akadtál el? Írj az info@arfigyelo.com címre — segítünk az összekötésben.