Доступ до демосередовища#

Ця довідка проведе вас через створення власного застосунку для Mergado Store, його підключення до Mergado API та безпечне тестування безпосередньо в Mergado без потреби платити. Mergado дає розробникам змогу створювати власні інтеграції, які розширюють функції редактора або взаємодіють з його API. Офіційного «демосередовища» з наперед завантаженими даними не існує — натомість за кілька кроків ви підготуєте власний тестовий проєкт.

Покрокова інструкція#

1) Створіть обліковий запис у Mergado#

Якщо облікового запису ще не маєте, створіть його на app.mergado.com.

2) Створіть власний застосунок#

1. Відкрийте: https://app.mergado.com/developers/create-app/
2. Заповніть основні дані про застосунок.
3. Після створення отримаєте облікові дані для доступу (точніше, доступ до сутностей, у яких застосунок увімкнено).

3) Підготуйте тестовий проєкт (якщо застосунок працює на рівні проєкту)#

1. У Mergado створіть новий проєкт для тестування.
2. Завантажте до нього тестовий фід — достатньо вашого невеликого фіду з кількома товарами.
3. У налаштуваннях проєкту перемкніть проєкт у тестовий режим, щоб за тестування не платити.

4) Увімкніть застосунок у проєкті#

У налаштуваннях проєкту дозвольте (увімкніть) свій застосунок. Так він отримає доступ до сутностей (фідів/проєктів), які має право читати й змінювати.

5) Авторизація та виклики API#

• Порядок авторизації: https://mergado.github.io/docs/api/authorization.html
• Документація API: https://mergado.docs.apiary.io/#

Зважайте на версію API: версія, яку ви використовуєте, впливає на поведінку ендпоінтів. Якщо версія не збігається, поведінка може відрізнятися від документації.

Поради для ефективного тестування#

• Центрального демомагазину не існує, кожен розробник готує власний тестовий проєкт.
• Тестовий режим гарантує, що за тестування ви не платите.
• Якщо застосунок потребує доступу на рівні проєкту, дозвольте його в конкретному проєкті.
• Для швидких тестів достатньо невеликого фіду з кількома товарами, не потрібно завантажувати робочі дані.
• Використовуйте окремий тестовий обліковий запис/проєкт для інтеграцій, щоб не втручатися в робочі дані.

Часті запитання#

Чи існує офіційне демосередовище з даними?#

Ні. Центральних демоданих немає. Створіть власний тестовий проєкт у Mergado.

Де створити обліковий запис у Mergado?#

На app.mergado.com.

Де створити свій застосунок?#

На https://app.mergado.com/developers/create-app/. Після заповнення основних даних отримаєте доступ до сутностей, у яких застосунок увімкнено.

Як тестувати без оплати?#

У налаштуваннях проєкту увімкніть тестовий режим.

Чи потрібен мені проєкт, якщо мій застосунок працює з проєктами?#

Так. Створіть тестовий проєкт, завантажте невеликий фід і застосунок у проєкті дозвольте.

Як надати застосунку доступ до даних проєкту?#

У налаштуваннях проєкту застосунок увімкніть. Так він отримає доступ до фідів/проєктів, які може читати/змінювати.

Де знайти порядок авторизації в API?#

У документації: https://mergado.github.io/docs/api/authorization.html.

Де повна документація API?#

На https://mergado.docs.apiary.io/#.

Ендпоінт поводиться інакше, ніж у документації. Що робити?#

Перевірте версію API. Поведінка ендпоінтів залежить від версії, і інша версія може призвести до іншої поведінки.

Наскільки великий фід використовувати для тестів?#

Достатньо невеликого фіду з кількома товарами — він ідеальний для швидких ітерацій.

Як захистити робочі дані під час розробки?#

Використовуйте окремий тестовий обліковий запис/проєкт, щоб зміни не зачепили робоче середовище.