Fejlesztői dokumentáció

Teszt-fiók

Mintaadatokkal feltöltött próbafiók, amelyre jóváhagyás és előfizetés nélkül telepítheted az appodat. Semmi nem megy ki belőle, és bármikor visszaállítható.

Kb. 5 perc olvasás

Mi a teszt-fiók?

Tudnivaló

A teszt-fiók ezen a környezeten még nincs bekapcsolva. Addig a saját Dynex-fiókodra telepítve tesztelhetsz (gyorsindítás, 6. lépés); az alábbiak a bekapcsolás után érvényesek.

A teszt-fiók a saját próbafiókod: egy mintaadatokkal feltöltött étterem (vendégek, foglalások, asztalok, étlap, rendelések, értékelések), amelyen az appod ugyanazt a v3 API-t, OAuth-folyamatot és webhookokat használja, mint élesben. Fejlesztőnként egy van, előfizetés nem kell hozzá, és a fejlesztői portálon az app „Teszt-fiók” fülén hozod létre.

  • Semmi nem megy ki belőle: a teszt-fiókból nem megy ki e-mail, SMS és push, és automatizálás sem indul el. Az API ilyenkor is sikeres választ ad, a levelet pedig a Dynex elfogja: a „Teszt-fiók” fülön 7 napig megnézheted. Ne a postafiókodban keresd.
  • Nincs felülete: a teszt-fiókba a Dynex alkalmazásban nem lehet belépni. Az adatait az API-n éred el, a portálon pedig az „API-próba” fülön a böngészőből hívhatod a végpontokat, a „Beágyazás-próba” fülön a beágyazott oldalaidat nézheted meg a Dynex keretében.

Miről ismered fel

A teszt-fiók bérlő-azonosítója mindig sbx_ előtaggal kezdődik, éles fióké soha. Ugyanezt jelzi a token-válasz és a GET /me sandbox: true mezője, valamint a válaszok X-Dynex-Sandbox: true fejléce. Az SDK-ban: isSandboxTenantId(tenantId).

cURL
1curl -X GET 'https://prod.dynex.hu/api/v3/me' \2  -H 'Authorization: Bearer dxk_A_TELEPITES_KULCSA' \3  -H 'Accept: application/json'
Node.js
1// Node.js 18+ (beépített fetch, nem kell külön csomag).2async function main() {3  const res = await fetch("https://prod.dynex.hu/api/v3/me", {4    method: "GET",5    headers: {6      "Authorization": "Bearer dxk_A_TELEPITES_KULCSA",7      "Accept": "application/json"8    }9  });10 11  const data = await res.json();12  console.log(res.status, data);13}14 15main().catch(console.error);

Telepítés

A „Teszt-fiók” fülön „Telepítés a teszt-fiókra”. A Dynex valódi code-dal küld az első regisztrált redirect URI-dra (state nélkül, mint a piactéri telepítésnél), a szervered pedig a szokásos token-cserével kap kulcsot. Jóváhagyás nem kell hozzá: jóváhagyott appnál a jóváhagyott verzió települ, egyébként a munkapéldányod. Havidíjas appért a teszt-fiók nem fizet.

A token-csere lépései: OAuth és hatókörök. Helyi fejlesztéshez a redirect URI http://localhost cím is lehet.

Visszaállítás

A „Visszaállítás” gomb friss mintaadatokat ad, új bérlő-azonosítóval. A telepítéseid megszűnnek, a kulcsuk érvénytelen lesz, az appod pedig app.uninstalled eseményt kap reason: "sandbox_reset" okkal - utána telepítsd újra. Naponta legfeljebb 10 visszaállítás megy, kettő között 5 perc szünettel.

Keretek

Mire vonatkozikKeret
Egy kulcspercenként 60 kérés (élesben az alap 120)
A teszt-fiók összes kulcsa együttpercenként 120 kérés
Egy telepítésnapi 20 000 kérés (a számláló 00:00 UTC-kor indul újra)

A keret állását a válaszok X-RateLimit-* fejlécei mutatják; a leírásuk a Kulcsok és biztonság oldalon van.

Teszt-fiók csapatban

A teszt-fiók a fejlesztői fiókhoz tartozik, nem egy személyhez. Ha a fiókot többen használjátok, mindenki ugyanazt a teszt-fiókot, ugyanazokat a mintaadatokat és ugyanazokat a telepítéseket látja. Hogy ki hozhatja létre, állíthatja vissza vagy telepíthet rá, az a szerepétől függ: Csapat és szerepek.

A visszaállítás mindenkit érint

A teszt-fiókot a csapat közösen használja - a visszaállítás mindenkinek törli az adatait és a telepítéseit. Szólj a többieknek, mielőtt visszaállítod.

  • A keretek is közösek: a teszt-fiók összes kulcsára együtt érvényes percenkénti keretet és a napi visszaállítások számát a csapat együtt fogyasztja.
  • A saját Dynex-fiókra telepítés (draft app, a gyorsindítás 6. lépése) a fejlesztői fiók tulajdonosának útja maradt; a csapattagok a közös teszt-fiókon tesztelnek.