API-клиент бессонницы

Insomnia — это кроссплатформенный API-клиент с открытым исходным кодом для GraphQL, REST, WebSockets, событий, отправленных сервером (SSE), gRPC и любого другого протокола, совместимого с HTTP.

С «Бессонницей» вы можете:

Отладка API с использованием самых популярных протоколов и форматов.
Создавайте API с помощью встроенного редактора OpenAPI и визуального предварительного просмотра.
Тестируйте API с помощью собственных наборов тестов и средства запуска коллекций.
Имитирующие API с использованием облачного или локального макетного сервера.
Создавайте конвейеры CI/CD, используя встроенный интерфейс командной строки Insomnia для анализа и тестирования.
Сотрудничайте с другими, используя множество функций совместной работы.
И многое другое, включая возможность использования сторонних плагинов.

Для ваших проектов, коллекций, спецификаций дизайна и всех других ресурсов Insomnia поддерживаются следующие варианты хранения:

Local Vault : для 100% локального хранения коллекций, спецификаций дизайна и любых других ресурсов.
Git Sync : для хранения Git с использованием любого стороннего репозитория Git без использования облака.
Cloud Sync : для совместной работы в облаке, опционально со сквозным шифрованием (E2EE) в облаке.

Начните бесплатно

Insomnia доступна для Mac, Windows и Linux, ее можно загрузить с веб-сайта:

https://insomnia.rest

Аккаунт и подписки

Вы можете использовать Insomnia без учетной записи в локальном Блокноте или можете создать учетную запись бесплатно, чтобы получить доступ ко всем возможностям продукта.

Даже при наличии учетной записи Insomnia сохраняет ваши проекты и файлы только в соответствии с выбранным вами серверным хранилищем , которым может быть Local Vault, Cloud Sync, Git Sync или любая их комбинация. Таким образом, например, у вас есть свобода выбора: хранить конфиденциальные проекты на 100 % локально или в репозитории Git, сохраняя при этом возможность совместной работы над другими проектами в облаке. Это лучшее из обоих миров.

Для дополнительной безопасности Insomnia также предлагает функцию частных сред , при которой конфигурация вашей среды всегда хранится локально, а не в облаке, независимо от варианта хранения, который вы выбрали для своего проекта.

Премиум-функции и поддержка

Insomnia имеет очень щедрый бесплатный план, который подойдет большинству пользователей, но если вам нужно получить доступ к премиум-возможностям, таким как неограниченное сотрудничество, функция Git Sync, возможность создавать организации для ваших проектов, используя сторонний IDP для входа в систему. (SAML, OIDC) и многие другие функции, после чего вы сможете изучить другие планы подписки.

Вы можете сравнить все планы подписки и начать работу бесплатно.

Почему Insomnia требует учетной записи?

Insomnia не требует учетной записи, если вы решите использовать локальный Блокнот , но для доступа к большинству возможностей продукта нам необходима учетная запись. Данные вашей учетной записи надежно хранятся в соответствии с требованиями ISO27001, SOC 2 Type II, ISO27018, Gold CSA STAR, а также в соответствии с нашими условиями обслуживания и политикой конфиденциальности.

Нам необходима учетная запись для устойчивого создания и улучшения продукта, а также для того, чтобы мы могли продолжать предлагать многие основные возможности в бесплатном дистрибутиве с открытым исходным кодом. Хотя программное обеспечение с открытым исходным кодом можно использовать бесплатно, его, к сожалению, нельзя создавать бесплатно, и наша способность продолжать работу над Insomnia зависит от нашей способности конвертировать подмножество бесплатных пользователей (которым нужны премиум-функции) в платящих клиентов нашего продукта. .

Если вы являетесь пользователем, который не может передавать данные API, такие как коллекции и спецификации дизайна, в облако, это все равно возможно, выбрав «Локальное хранилище» в качестве хранилища ваших проектов Insomnia: наличие учетной записи Insomnia не привязано к тому, как вы хотите хранить ваши конфиденциальные данные API (которые могут храниться на 100% локально через Local Vault, в стороннем репозитории Git без какого-либо облачного хранилища через Git Sync или в облаке для удобства совместной работы через Cloud Sync).

Ошибки и пожелания

Есть ошибка или запрос на добавление функции? Сначала прочтите правила по проблемам и найдите существующие и закрытые проблемы. Если ваша проблема или идея еще не решена, откройте новый выпуск.

Чтобы получить более общие вопросы о продуктах и оставить отзывы, присоединяйтесь к команде Slack.

Содействие

Пожалуйста, ознакомьтесь с нашими рекомендациями по участию и кодексом поведения. Включены указания по раскрытию проблем, стандарты кодирования и примечания по разработке.

Документация

Ознакомьтесь с нашей официальной документацией по Insomnia.

Развивайте бессонницу

Разработку Insomnia можно вести на Mac, Windows или Linux, если у вас есть Node.js и Git. Правильную версию Node смотрите в файле .nvmrc , расположенном в проекте.

Начальная настройка для разработчиков

Этот репозиторий структурирован как монорепозиторий и содержит множество пакетов Node.JS. Каждый пакет имеет свой собственный набор команд, но наиболее распространенные команды доступны из корневого файла package.json , и к ним можно получить доступ с помощью команды npm run … . Вот единственные три команды, которые вам понадобятся, чтобы начать разработку приложения.

 # Установить и связать зависимостиnpm i# Запустить Lintnpm run lint# Запустить проверку типаnpm run type-check# Запустить Testsnpm test# Запустить приложение с Live Reloadnpm run dev

Линукс

Если вы используете Linux, вам может потребоваться установить следующие вспомогательные пакеты:

Убунту/Дебиан

 # Обновить библиотеку sudo apt-get update# Установить библиотеку конфигурации шрифтов и поддержку sudo apt-get install libfontconfig-dev

Федора

 # Установите libcurl для node-libcurlsudo dnf install libcurl-devel

Также в Linux, если Electron не работает во время процесса установки, запустите следующую команду:

 # Очистить конфликты установки Electronrm -rf ~/.cache/electron

Окна

Если вы используете Windows и у вас возникли проблемы, вам может потребоваться установить инструменты сборки Windows.

Требования к редактору

Вы можете использовать любой редактор, который вам нравится, но убедитесь, что у вас есть поддержка/плагины для следующих инструментов:

ESLint — для выявления синтаксических проблем и распространенных ошибок.
Синтаксис JSX — для компонентов React

Разработка интерфейса командной строки Inso

npm i
Запустите компилятор в режиме просмотра: npm run inso-start
Запустите: ./packages/insomnia-inso/bin/inso -v

Плагины

Ищите, находите и устанавливайте плагины в Центре плагинов Insomnia!

Общественные проекты

Документатор Insomnia — создавайте красивые страницы документации по API с помощью плагина документатора или файла экспорта Insomnia.
Средство импорта спецификаций GitHub API — полный набор спецификаций маршрутов GitHub REST API, которые можно импортировать прямо в Insomnia.
Swagger — создайте документацию Swagger для существующего API в Insomnia.