Fejlesztői API

A katalógus-szinkron API-val a saját rendszeredből egyetlen kéréssel frissítheted a NOSEC AI teljes termékkatalógusát.

Elérhetőség és limitek

Egy üzlet legfeljebb 5 percenként indíthat szinkront. Túllépéskor az API 429 választ és Retry-After fejlécet küld.

API-kulcs és hitelesítés

1. Az Admin felületen nyisd meg a Beállítások → Fejlesztői API lapot.
2. Generálj API-kulcsot, majd azonnal másold biztonságos helyre. A teljes kulcs csak egyszer látható.
3. Küldd a kulcsot minden kérésben Bearer tokenként.

Authorization: Bearer nsa_...

Újrageneráláskor a régi kulcs azonnal érvénytelenné válik. A NOSEC AI kizárólag a kulcs hashét tárolja.

Katalógus szinkronizálása

POST /api/v1/catalog/sync

curl -X POST https://api.nosec-ai.hu/api/v1/catalog/sync \
  -H "Authorization: Bearer nsa_A_KULCSOD" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "external_id": "SKU-1001",
      "name": "Fekete futócipő",
      "description": "Könnyű, párnázott modell.",
      "price": "24 990 Ft",
      "currency": "HUF",
      "url": "https://pelda.hu/termek/futocipo",
      "image_url": "https://pelda.hu/img/futocipo.jpg",
      "category": "Cipők",
      "brand": "Példa",
      "stock_status": "raktáron",
      "on_sale": true,
      "original_price": "29 990 Ft"
    }]
  }'

Az érvénytelen vagy ismétlődő sorokat a rendszer kihagyja és a warnings listában jelzi:

{
  "status": "ok",
  "received": 3,
  "synced": 2,
  "warnings": [{"index": 2, "message": "Az external_id mező kötelező."}]
}

Szinkron állapota

GET /api/v1/catalog/status

curl https://api.nosec-ai.hu/api/v1/catalog/status \
  -H "Authorization: Bearer nsa_A_KULCSOD"

{
  "status": "ok",
  "product_count": 2,
  "last_sync_at": "2026-09-06T14:30:00+00:00",
  "plan": "starter",
  "max_products": 200
}

HTTP hibakódok