Перехід із Postman
1. Експорт із Postman
Section titled “1. Експорт із Postman”У Postman: Collection ▸ … ▸ Export ▸ Collection v2.1. Зробіть те саме для своїх середовищ.
2. Імпорт до Restorm
Section titled “2. Імпорт до Restorm”Файл ▸ Імпортувати (Ctrl+I), а потім файл JSON. Restorm визначає формат
самостійно.
Подробиці: Імпорт колекції Postman.
Що переноситься автоматично
Section titled “Що переноситься автоматично”| Postman | Restorm |
|---|---|
| Теки | Теки тієї самої глибини |
| Запити HTTP | Запити HTTP |
| Запити GraphQL | Запити GraphQL (а не запити HTTP) |
| Тіла raw, formdata, urlencoded, file, graphql | Відповідний тип тіла |
| Змінні колекції | Змінні середовища |
| Описи | Нотатки й документацію API |
| Зразки відповідей | Документацію API |
| Скрипти до запиту й тестові скрипти | Виконуваний сценарій із шаром pm.* |
Що потребує коригування
Section titled “Що потребує коригування”Автентифікація
Section titled “Автентифікація”Блоки автентифікації Postman документуються (із прихованими чутливими значеннями), але не перетворюються на виконувані облікові дані.
Створіть запит автентифікації наново: це
справа п’яти хвилин, а ви отримуєте автоматичне поновлення токена й повторну
спробу після 401, чого Postman самостійно не робить.
Середовища
Section titled “Середовища”Експортуйте їх із Postman і створіть наново в теці середовищ.
Скористайтеся нагодою застосувати підсередовища: там, де Postman нав’язує плоске середовище на кожну ціль, Restorm дозволяє спільну основу й перевизначення для кожного клієнта чи регіону.
Runner-и та Newman
Section titled “Runner-и та Newman”Це найвигідніша заміна. Сценарій робить те саме, що й runner, тільки краще:
- потік видно замість неявного порядку колекції;
- розгалуження, цикли й повторні спроби є блоками, а не
pm.setNextRequest; - виконання в CI вбудоване, з охайними кодами виходу — див. Безекранне виконання та CI.
Відповідність понять
Section titled “Відповідність понять”| Postman | Restorm |
|---|---|
| Workspace | Проєкт .restorm під контролем версій у git |
| Collection | Тека або тека середовищ |
| Environment | Середовище в теці середовищ |
| Globals | Кореневе середовище, успадковане нащадками |
| Pre-request / Test script | Сценарій або дія з кодом |
| Collection Runner | Сценарій |
| Newman | restorm --run --headless |
| Mock Server | Режим сервера, локально |
| Monitors | Дія Таймер або заплановане завдання вашого CI |
| Postman Console | Консоль |
Динамічні змінні {{$random…}} | Ті самі, плюс 116 помічників — див. довідник |
Принципова відмінність
Section titled “Принципова відмінність”Ваші запити стають файлами у вашому репозиторії. Вони проходять той самий цикл перегляду, що й ваш код, їхня історія — це історія git, а права доступу — права вашої платформи для коду.
Жодного хмарного робочого простору, який треба адмініструвати, і жодних даних
API у сторонній службі. Див.
Проєкти та файли .restorm.
А що є в Postman, чого немає в Restorm
Section titled “А що є в Postman, чого немає в Restorm”Якщо чесно: у Restorm немає хмарного спільного робочого простору, немає публічного порталу API, немає вбудованих коментарів до запитів і немає хмарного моніторингу. Якщо ваша організація спирається на ці елементи, прямого відповідника їм немає — спільна робота проходить через git.