Adatlap, beküldés, szabályzat
Mit látnak a bérlők az appodról a piactéren, hogyan jut el egy verzió a beküldéstől a közzétételig, és milyen szabályokhoz méri a bírálat.
Az adatlap az, amit a bérlők a piactéren látnak az appodról. Az alapja a név (legfeljebb 80 karakter), a rövid leírás (legfeljebb 140), a részletes leírás (legfeljebb 5000), az ikon és a honlap címe. A hosszabb szöveget a portál nem vágja le, hanem hibát jelez. A beküldés előtti ellenőrzés szól, ha a rövid leírás 20, a részletes leírás 100 karakternél rövidebb. A részletes leírásban egyszerű formázás használható: félkövér, dőlt, lista és link. Link csak https lehet, és a piactér a link szövege után kiírja, melyik címre visz.
Tudnivaló
Az alábbi bővített mezők és a képfeltöltés ezen a környezeten még nincsenek bekapcsolva: itt az adatlap az alapmezőkből áll, az ikont pedig https címmel adod meg.
| Mező | Szabály |
|---|---|
| Kategória | Legfeljebb 2; beküldéshez legalább egy kell. Választható: Foglalás és asztalkezelés, Rendelés és kiszállítás, Kassza és fizetés, Marketing és hírlevél, Törzsvendég és hűség, Értékelések és visszajelzés, Számlázás és könyvelés, Munkaidő és beosztás, Készlet és beszerzés, Riportok és elemzés, Egyéb. |
| Kulcsszavak | Legfeljebb 8, egyenként 2-30 karakter. A piactéri keresés ezekben is keres. |
| Fő funkciók | Legfeljebb 3; a cím legfeljebb 60, a szöveg legfeljebb 200 karakter. |
| Képernyőképek | Legfeljebb 6. Mindegyikhez kell egy rövid leíró szöveg (legfeljebb 140 karakter), amit a képernyőolvasók felolvasnak. |
| Bemutató videó | Nem kötelező. Csak https link lehet, ezekről az oldalakról: youtube.com, youtu.be, loom.com, vimeo.com. |
| Támogatás | Weboldal (https) vagy e-mail cím. Beküldéshez legalább az egyik kell, hogy a bérlő tudja, kihez fordulhat. |
| Adatkezelési tájékoztató | A tájékoztatód https címe. Beküldéshez kell. |
A képeket a Dynexre töltöd fel a portál Adatlap fülén; a piactér csak ilyen, nálunk tárolt képernyőképet mutat. Elfogadott formátum: PNG, JPEG, WEBP, fájlonként legfeljebb 4 MB; animált kép nem tölthető fel. Egy apphoz legfeljebb 40 feltöltött fájl tartozhat (a már sehol nem használt képeket a rendszer a korlát elérésekor törli).
| Kép | Amit feltölthetsz | Amit tárolunk |
|---|---|---|
| Ikon | Négyzetes kép, legalább 256 × 256 képpont. | 512 × 512 képpontos PNG. |
| Képernyőkép | Fekvő kép, legalább 1200 képpont széles; a szélesség és a magasság aránya 1,3 és 1,8 közé esik. | WebP, legfeljebb 1600 képpont széles (kisebb képet nem nagyítunk fel). |
Ha a kép nem felel meg, a feltöltés a mért mérettel együtt mondja meg, mi a gond. A külső címen tárolt ikon egyelőre megengedett, de azt javasoljuk, töltsd fel: a külső ikon minden megjelenítéskor a te szerveredről töltődik, és a csak adatlapot érintő módosítás gyorsabb sávja is feltöltött ikont kíván.
A marketplace-re csak a Dynex csapata által jóváhagyott verzió kerül ki. Beküldeni a portál Verziók fülén tudsz: a beküldő ablak megmutatja, mi hiányzik még, és melyik bírálati sávba kerül a beküldés. Egy appnak egyszerre egy nyitott beküldése lehet (bírálatra váró, vagy jóváhagyott, de még közzé nem tett); amíg nyitva van, a munkapéldány nem szerkeszthető. Élő appnál a beküldés nem szünteti meg az élő verziót. A bírálatra nincs garantált határidő.
A döntésről e-mailt kapsz, és a portál is jelzi, ha teendőd van vele. Felfüggesztett appnak és felfüggesztett fejlesztői fióknak új verziója semmilyen úton nem élesedik, amíg a felfüggesztés tart. Hatókör-bővítés közzététele után a meglévő telepítések a régi hatókörökkel futnak tovább, az új hatókört a bérlő újbóli hozzájárulása (az OAuth-link ismételt megnyitása) adja.
| Sáv | Mikor | Mit jelent |
|---|---|---|
| Első beküldés | Az appnak még nincs élő verziója. | Teljes bírálat: a működést, a hozzáféréseket és az adatlapot is megnézzük. |
| Teljes bírálat | A változás a nevet, a hatóköröket, a visszairányítási címeket, az app URL-t, a webhookot, a beágyazásokat vagy az árat is érinti. | Teljes bírálat az élő verzióhoz képesti különbségre. |
| Adatlap-módosítás | Csak a rövid és a részletes leírás, a honlap címe, a Dynexre feltöltött ikon vagy az adatlap bővített mezői változnak. | Jóváhagyáskor kizárólag ezek a mezők frissülnek az élő verzióban; a hozzáférések, a végpontok és az ár biztosan nem módosulnak. |
A sávot a szerver állapítja meg a munkapéldány és az élő verzió különbségéből; választani nem lehet.
| Mező | Mikor kell | Mire való |
|---|---|---|
| Mi változott? | Frissítésnél, legalább 20, legfeljebb 1000 karakter. | A bírálónak szól: röviden, mi más az élő verzióhoz képest. |
| Újdonságok | Frissítésnél, legalább 10, legfeljebb 600 karakter. Új hatókörnél azt javasoljuk, legalább 40 karakterben indokold meg, mire kell. | A bérlőknek szól: a jóváhagyott és közzétett verziónál a piactér verziótörténetében jelenik meg. |
| Tesztelési útmutató | Első beküldésnél és teljes bírálatnál, legalább 50, legfeljebb 4000 karakter. | Hogyan tudjuk kipróbálni az appot: mit állítsunk be, mit kell látnunk. |
| Teszt-hozzáférés | Nem kötelező, legfeljebb 2000 karakter. | Belépési adat a kipróbáláshoz. Titkosítva tároljuk, csak a Dynex bírálói nyithatják meg, a megnyitást látod a tevékenységnaplóban. A bírálat lezárása után töröljük. |
| Bemutató videó | Nem kötelező. | Https link ezekről az oldalakról: youtube.com, youtu.be, loom.com, vimeo.com. |
| Közzététel módja | Mindig. | Jóváhagyás után azonnal élesedjen, vagy te teszed közzé, amikor készen állsz. |
| Állapot | Jelentés |
|---|---|
| Sorban | Megkaptuk, a bírálat még nem kezdődött el. Látod, hány beküldés áll előtted. Amíg nincs döntés, visszavonhatod. |
| Vizsgálat alatt | Egy bíráló dolgozik rajta. Döntésig ilyenkor is visszavonhatod. |
| Módosítást kérünk | A bíráló észrevételeket írt; mindegyik egy szabályra hivatkozik. A munkapéldány újra szerkeszthető: javíts, válaszolj az észrevételekre („Kijavítottam” vagy indoklással „Nem értek egyet”), majd küldd be újra. Az új beküldés a következő kör. |
| Elutasítva | A kör indoklással lezárult. Új beküldést bármikor indíthatsz, ha az indokolt problémát megoldottad. |
| Visszavonva | Te vontad vissza a döntés előtt. A munkapéldány szerkeszthető, a csomag szövege megmarad a következő beküldéshez. |
| Jóváhagyva - közzétételre vár | Jóváhagytuk, de még nem él: a Verziók fülön azonnal közzéteheted, időzítheted vagy elvetheted. A jóváhagyás 60 napig érvényes, utána a verziót újra be kell küldeni. |
| Jóváhagyva - időzítve | A megadott időpontban élesedik. Egész órára időzíthetsz, legfeljebb 60 nappal előre; a közzététel a megadott óra első perceiben történik meg. Addig bármikor közzéteheted kézzel, vagy törölheted az időzítést. |
| Jóváhagyva és közzétéve | A beküldött pillanatkép lett az élő verzió. A további szerkesztés a munkapéldányt írja, újabb beküldésig nem látszik. |
| Nem lett közzétéve | A jóváhagyott verzió közzététel nélkül lezárult: elvetetted, lejárt a jóváhagyás, vagy a Dynex visszavonta. A munkapéldány újra szerkeszthető. |
| Felülírta egy újabb beküldés | A jóváhagyott verzió már nem tehető közzé, mert közben megváltozott az élő verzió, vagy újabb beküldés született. |
| Állapot | Jelentés |
|---|---|
draft | Munkapéldány: a teszt-fiókodra és a saját (tag) fiókodra telepíthető, másra nem. |
submitted | Az első beküldés bírálatra vár; a bíráló a beküldött pillanatképet látja. |
approved | Élő a marketplace-en. Újabb beküldés alatt is az utoljára közzétett verzió él. |
rejected | A legutóbbi beküldés nem lett jóváhagyva, és az appnak nincs élő verziója; javítás után újra beküldhető. |
suspended | Felfüggesztve: minden telepítés kulcsa érvénytelen, a menüpontok eltűnnek, az OAuth nem működik, a bérlők havidíja a hónap végére lemondva. |
A bírálat ezekhez a szabályokhoz méri a beküldést, és a bíráló minden észrevétele egy szabályra hivatkozik - a portálon az észrevétel mellől ide jutsz. A szabályok azonosítója nem változik, a szövegük pontosodhat. Érvényes változat: 2026-10-08. Ami egyik szabályhoz sem köthető, azt a bíráló „Egyéb észrevétel” címen, saját szavaival írja le.
Követelmény · 1. Általános
Az adatlapon leírt funkcióknak a beküldött verzióban működniük kell. Tervezett, még el nem készült funkciót ne ígérj az adatlapon. Amit az app csinál, annak a leírásból ki kell derülnie.
Nem felel meg: a leírás automatikus foglalás-visszaigazolást ígér, de az app csak listázza a foglalásokat.
Követelmény · 1. Általános
A fejlesztői profilban valós szervezet vagy személy szerepeljen. Az adatlapon legyen olyan támogatási weboldal vagy e-mail-cím, amelyen az appot használó cég válaszra számíthat.
Megfelel: support@peldaceg.hu, amelyről válasz érkezik. Nem felel meg: nem létező domain vagy visszapattanó cím.
Követelmény · 1. Általános
A név, az ikon és a leírás nem utalhat arra, hogy az appot a Dynex vagy egy másik cég készítette, ha ez nem igaz. Más márka nevét csak az integráció tényszerű megnevezésére használd.
Megfelel: „Számlázó-kapcsolat a Dynexhez”. Nem felel meg: „Dynex Hivatalos Számlázó” vagy a Dynex-logó az ikonban.
Követelmény · 2. Működés
A hozzájárulás megadása után a Dynex a regisztrált visszairányítási címre küldi a felhasználót. Az appnak ott be kell váltania a kódot, és használható állapotba kell kerülnie. Hibaoldal, végtelen töltés vagy üres képernyő nem fogadható el.
Megfelel: a visszairányítás után az app a „Sikeres összekapcsolás” oldalt mutatja, és a beágyazott menüpont azonnal működik.
Követelmény · 2. Működés
Az eltávolítással a telepítés hozzáférése megszűnik. Az appnak le kell állítania az időzített feladatait erre a telepítésre, és nem próbálkozhat tovább a visszavont kulccsal.
Nem felel meg: az eltávolítás után az app óránként tovább próbálja lekérni a foglalásokat, és 401-es válaszokat gyűjt.
Követelmény · 2. Működés
A beágyazott menüpont oldala a Dynex keretében töltődik be, ezért engednie kell a keretbe ágyazást a Dynex felől. A beágyazási token rövid életű: lejárat után az oldalnak újat kell kérnie, nem állhat meg hibával.
Nem felel meg: az oldal X-Frame-Options: DENY fejlécet küld, ezért a keret üres marad.
Követelmény · 2. Működés
A beküldéshez írd le lépésenként, hogyan próbálható ki az app fő funkciója. Ha a kipróbáláshoz fiók kell a saját rendszeredben, adj teszt-hozzáférést. Amit nem tudunk kipróbálni, azt nem tudjuk jóváhagyni.
Megfelel: „1. Telepítsd az appot. 2. Nyisd meg a Riportok menüpontot. 3. Válassz hónapot: megjelenik a foglalási összesítő.”
Ajánlott gyakorlat · 2. Működés
Ha valami nem sikerül, a felhasználó tudja meg, mi történt és mit tehet. Nyers hibakód vagy angol technikai üzenet helyett adj rövid, magyar magyarázatot.
Megfelel: „Nem sikerült betölteni a foglalásokat. Próbáld újra pár perc múlva.” Nem felel meg: „Error 500: undefined”.
Követelmény · 3. Biztonság és adatkezelés
Az éles app minden címe nyilvános https cím legyen: a visszairányítási címek, az app URL és a webhook URL is. A localhost csak fejlesztéshez, sandbox telepítéssel használható.
Megfelel: https://app.peldaceg.hu/oauth/callback. Nem felel meg: http://localhost:3000/callback a beküldött verzióban.
Követelmény · 3. Biztonság és adatkezelés
A Dynex minden webhook-kérést aláír. Az appnak a feldolgozás előtt ellenőriznie kell az aláírást és az időbélyeget, és az érvénytelen kérést el kell utasítania. Aláírás-ellenőrzés nélkül bárki hamis eseményt küldhet a végpontodra.
Megfelel: hibás aláírásra a végpont 401-et válaszol, és nem dolgozza fel a kérést.
Követelmény · 3. Biztonság és adatkezelés
A client secret és a telepítések API-kulcsai csak a szervereden lehetnek. Nem kerülhetnek a böngészőnek küldött kódba, mobilappba, nyilvános tárolóba vagy naplóba.
Nem felel meg: a beágyazott oldal JavaScript-kódjában olvasható a dxas_ kezdetű kulcs.
Követelmény · 3. Biztonság és adatkezelés
Az adatlapon megadott adatkezelési tájékoztató legyen elérhető, és írja le, hogy ez az app milyen adatot kezel és mire használja. Általános céges oldal, amely az appot nem említi, nem elég.
Megfelel: https://peldaceg.hu/adatkezeles, amely külön szakaszban írja le a Dynexből átvett adatokat.
Követelmény · 4. Engedélyek
Minden kért hatókörhöz tartozzon olyan funkció, amely a leírásban szerepel és kipróbálható. „Hátha később kell” alapon ne kérj engedélyt: új funkcióhoz új verzióban kérheted.
Nem felel meg: egy foglalási riport-app a kapcsolatok olvasását is kéri, de sehol nem használja.
Követelmény · 4. Engedélyek
Írási hatókörrel az app csak azt módosíthatja, amit a leírás megnevez és a felhasználó elvár. Háttérben végzett, a felhasználó számára váratlan módosítás nem megengedett.
Megfelel: a felhasználó a „Szinkronizálás” gombra kattint, és az app frissíti a kapcsolatok címkéit, ahogy a leírás mondja.
Követelmény · 4. Engedélyek
Egy webhook-eseményre az app csak akkor iratkozhat fel, ha az esemény erőforrásához tartozó hatókört is kéri. Az alapértelmezett eseményekhez webhook URL is kell.
Nem felel meg: a foglalás-eseményekre feliratkozó app nem kéri a foglalások olvasását.
Követelmény · 5. Adatlap
Az app neve különbözzön a piactéren már szereplő appok nevétől, és ne legyen összetéveszthető velük. A név az appot nevezze meg, ne általános kulcsszavak sora legyen.
Nem felel meg: „Foglalás Pro” egy már élő „Foglalás-Pro” app mellett.
Követelmény · 5. Adatlap
A rövid leírás egy mondatban mondja meg, mire jó az app. A részletes leírás sorolja fel, mit csinál, kinek szól és mi kell a használatához. Mindkettő magyarul szóljon, túlzó állítások nélkül.
Megfelel: „Heti összesítőt küld e-mailben a foglalásaidról.” Nem felel meg: „A legjobb app a piacon!!!”
Követelmény · 5. Adatlap
Az ikon és a képernyőképek a beküldött app tényleges felületét mutassák. A képeket a fejlesztői portálon töltsd fel: így a jóváhagyott kép később nem változhat meg észrevétlenül.
Nem felel meg: stock fotó vagy egy másik termék képernyőképe.
Ajánlott gyakorlat · 5. Adatlap
A telepítés előtt a felhasználó a képekből látja, mit kap. Két-három jól megválasztott képernyőkép a fő funkcióról többet mond, mint egy hosszú leírás.
Megfelel: egy kép a fő nézetről, egy a beállításokról.
Követelmény · 5. Adatlap
Az app árát a piactér az árazási beállításból mutatja. A leírásba és a képekre ne írj árat, kedvezményt, kuponkódot vagy külső előfizetésre mutató felhívást, mert ezek a jóváhagyás után elavulhatnak és megtévesztők lehetnek.
Nem felel meg: „Most 50% kedvezménnyel!” felirat egy képernyőképen.
Követelmény · 5. Adatlap
Olyan kategóriát válassz, amelyben a felhasználó keresné az appot. A jobb láthatóság kedvéért választott, oda nem illő kategória nem fogadható el.
Nem felel meg: egy könyvelési export a „Marketing” kategóriában.
Követelmény · 6. Árazás
Havidíjas appnál a havi díj nettó forintösszeg, nullánál nagyobb. Az adatlap szövege nem állíthat az árról mást, mint amit az árazási beállítás tartalmaz.
Nem felel meg: a beállított díj 4 900 Ft, a leírás szerint az app ingyenes.
Követelmény · 7. Frissítések
A kiadási megjegyzés az appot használó cégeknek szól: mi változott, és kell-e tenniük valamit. Rövid, közérthető szöveg legyen, belső jegyszámok és fejlesztői zsargon nélkül.
Megfelel: „Új havi összesítő nézet. Teendőd nincs.”
Követelmény · 7. Frissítések
Ha egy frissítés új hatókört kér, a telepítő cégeknek újra hozzá kell járulniuk. A kiadási megjegyzés mondja meg, melyik új funkcióhoz kell az új engedély.
Megfelel: „Az új címkéző funkcióhoz a kapcsolatok módosítására kérünk engedélyt.”
Ajánlott gyakorlat · 7. Frissítések
A változás-összefoglaló a bírálónak szól: sorold fel benne mindazt, ami az élő verzióhoz képest változott. Ha a bíráló olyan eltérést talál, amelyről nem írtál, a bírálat tovább tart.
Megfelel: „Új hatókör: contacts.write a címkézéshez. Új beágyazott oldal: /cimkek. A webhook URL nem változott.”