Přístup k demo prostředí#

Tato nápověda vás provede vytvořením vlastní aplikace pro Mergado Store, její napojením na Mergado API a bezpečným testováním přímo v Mergadu bez nutnosti platby. Mergado umožňuje vývojářům tvořit vlastní integrace, které rozšiřují funkce editoru nebo komunikují s jeho API. Oficiální „demo prostředí“ s předem nahranými daty neexistuje — místo toho si během pár kroků připravíte vlastní testovací projekt.

Postup krok za krokem#

1) Založte si účet v Mergadu#

Pokud účet ještě nemáte, vytvořte si ho na app.mergado.com.

2) Vytvořte vlastní aplikaci (appku)#

1. Otevřete: https://app.mergado.com/developers/create-app/
2. Vyplňte základní údaje o aplikaci.
3. Po vytvoření získáte přístupové údaje (respektive přístup k entitám, u kterých je appka zapnutá).

3) Připravte testovací projekt (pokud aplikace pracuje na úrovni projektu)#

1. V Mergadu založte nový projekt pro testování.
2. Nahrajte do něj testovací feed – stačí váš malý feed s několika produkty.
3. V nastavení projektu přepněte projekt do testovacího režimu, aby se za testování neplatilo.

4) Zapněte aplikaci na projektu#

V nastavení projektu povolte (zapněte) vaši aplikaci. Tím získá přístup k entitám (feedům/projektům), které má právo číst a upravovat.

5) Autorizace a volání API#

• Postup autorizace: https://mergado.github.io/docs/api/authorization.html
• Dokumentace API: https://mergado.docs.apiary.io/#

Pozor na verzi API: Používaná verze ovlivňuje chování endpointů. Pokud verze nesouhlasí, může se chování lišit od dokumentace.

Tipy pro efektivní testování#

• Neexistuje centrální demo shop, každý vývojář si připravuje vlastní testovací projekt.
• Testovací režim zajistí, že za testování neplatíte.
• Pokud aplikace vyžaduje přístup na úrovni projektu, povolte ji na konkrétním projektu.
• Na rychlé testy stačí malý feed s pár produkty, není nutné nahrávat produkční data.
• Používejte samostatný testovací účet/projekt pro integrace, abyste nezasahovali do produkčních dat.

FAQ#

Existuje oficiální demo prostředí s daty?#

Ne. Nejsou k dispozici centrální demo data. Vytvořte si vlastní testovací projekt v Mergadu.

Kde založím účet do Mergada?#

Na app.mergado.com.

Kde vytvořím svou aplikaci?#

Na https://app.mergado.com/developers/create-app/. Po vyplnění základních údajů získáte přístup k entitám, kde je appka zapnutá.

Jak testovat bez poplatků?#

V nastavení projektu zapněte testovací režim.

Potřebuji projekt, když moje aplikace pracuje s projekty?#

Ano. Založte testovací projekt, nahrajte malý feed a aplikace na projektu povolte.

Jak aplikaci udělím přístup k datům projektu?#

V nastavení projektu aplikaci zapněte. Získá tak přístup k feedům/projektům, které může číst/upravovat.

Kde najdu postup autorizace vůči API?#

V dokumentaci: https://mergado.github.io/docs/api/authorization.html.

Kde je kompletní API dokumentace?#

Na https://mergado.docs.apiary.io/#.

Endpoint se chová jinak než v dokumentaci. Co s tím?#

Zkontrolujte verzi API. Chování endpointů je verzované a odlišná verze může vést k jinému chování.

Jak velký feed mám použít pro testy?#

Stačí malý feed s několika produkty – je ideální pro rychlé iterace.

Jak ochráním produkční data při vývoji?#

Používejte samostatný testovací účet/projekt, ať se změny nedotknou produkce.