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 („appky“), 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)
- Otevřete: https://app.mergado.com/developers/create-app/
- Vyplňte základní údaje o aplikaci.
- 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 appka pracuje na úrovni projektu)
- V Mergadu založte nový projekt pro testování.
- Nahrajte do něj testovací feed – stačí váš malý feed s několika produkty.
- V nastavení projektu přepněte projekt do testovacího režimu, aby se za testování neplatilo.
4) Zapněte appku na projektu
V nastavení projektu povolte (zapněte) vaši appku. 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 appka 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 appku?
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 appka pracuje s projekty?
Ano. Založte testovací projekt, nahrajte malý feed a appku na projektu povolte.
Jak appce udělím přístup k datům projektu?
V nastavení projektu appku 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.