Fejlesztői dokumentáció

Egy Dynex-app három dolgot kap a platformtól, és mindhármat a te kódod használja a saját szervereden - idegen kód soha nem fut a Dynex szerverein:

• Adathozzáférés: a bérlő a telepítéskor hozzájárul a kért hatókörökhöz, és az app egy dxk_ API-kulcsot kap, amely pontosan ezekre a hatókörökre jogosít a v3 API-n. Az eseményekről webhookon értesülsz.
• Saját felület: az app egy vagy több menüpontot kap a Dynex bal menüjének „Alkalmazások” szekciójában; a menüpont a te URL-edet tölti be iframe-ben, aláírt kontextussal (ki a bérlő, ki a felhasználó, milyen téma).
• Értékesítés: ingyenes vagy havidíjas app. A havidíj a bérlő meglévő Dynex-számlájára kerül; a fejlesztői részesedés alapértéke 80 %. A működését a Bevétel és elszámolás oldal írja le.

A marketplace-re csak a Dynex tulajdonosának jóváhagyása után kerül ki egy app, és minden új verzió, valamint minden hatókör-bővítés újra jóváhagyásra megy. Amíg nincs jóváhagyva, az appot a teszt-fiókodra vagy a saját Dynex-fiókodra telepítheted.

Az API végpontjainak teljes referenciája külön oldalon van: API dokumentáció. A fejlesztői portál (regisztráció, appok, elszámolás): /developer - előfizetés nem kell hozzá.

Ha most kezded, a Gyorsindítás visz végig az első működő telepítésig. A többi oldal egy-egy témát ír le részletesen.

• Gyorsindítás öt percbenProfil, app, telepítés a teszt-fiókra, első API-hívás, első webhook.
• OAuth és hatókörökA telepítés folyamata, a token-csere, a hibakódok és a kérhető hatókörök.
• Webhookok és eseményekAláírás-ellenőrzés, újrapróbálás, életciklus-események, helyi fejlesztés alagúttal.
• Beágyazott oldalakA kontextus-token, a postMessage híd és a Beágyazás-próba.
• Teszt-fiókMintaadatos próbafiók: telepítés, visszaállítás, keretek.
• Adatlap, beküldés, szabályzatMit kér a piactéri adatlap, hogyan megy a beküldés, mit néz a bírálat.
• Bevétel és elszámolásHogyan lesz a havidíjból elszámolási sor, és hol látod a portálon.
• Kulcsok és biztonságTöbb titkos kulcs, kérés-azonosító, keret-fejlécek, biztonsági követelmények.
• SDK és példa-appA TypeScript-csomag, a generált kliens, a verziók és a letöltések.
• Csapat és szerepekKik érik el a fejlesztői fiókot, és melyik szerep mit lát.
• VáltozásokAz API, az SDK, a portál és a szabályzat változásai, a legújabb elöl.
• API-referenciaA v3 API minden végpontja, mintakéréssel és válasszal.

SDK 0.2.0: a teljes API típusokkal, újrapróbálás és lapozás

2026-10-09 · SDK 0.2.0. A kliens a szerződésből generált felületet is megkapta: a client.v3 alatt a v3 API minden művelete elérhető a saját típusaival, a client.v1 alatt a régi felület. A korábbi metódusok (például contacts.list) változatlanul működnek. Figyelj rá: a GET hívások mostantól maguktól újrapróbálkoznak; ha saját újrapróbálód van, állítsd a maxRetries értékét 0-ra. Új: automatikus újrapróbálás átmeneti hibánál (429, 502, 503, 504, hálózati hiba, időkorlát), a paginate segédfüggvény a lapozott listákhoz, valamint a DynexTimeoutError és a DynexNetworkError hibaosztály. A letöltés a verziószámot is hordozza a fájlnévben; a régi fájlnév tovább él.

A dokumentáció külön oldalakra került, keresővel

2026-10-09 · Portál. Az eddigi egyetlen hosszú útmutató témánként külön oldal lett, kereséssel és oldalanként másolható Markdown-szöveggel. A régi horgonyok (például #webhook) a megfelelő új oldalra visznek. Új a Gyorsindítás rövid útja és a Bevétel és elszámolás oldal.

Bírálati szabályzat: 2026-10-08 változat

2026-10-08 · Szabályzat. A beküldéseket ehhez a változathoz mérjük. A szabályok azonosítója nem változott; a teljes szöveg a Bírálati szabályzat szakaszban olvasható.

Az összes bejegyzés: Változások.

npm install https://prod.dynex.hu/downloads/dynex-app-sdk-0.2.0.tgz

A csomag tartalmáról és a verziókról az SDK és példa-app oldal szól.