JWS.Консоль ↗
Разделы документации

API

Создать ключ

  1. Откройте API в JWS Console и нажмите Create API key.
  2. Укажите имя и выберите нужные разрешения. По умолчанию ни одно право не выбрано.
  3. Задайте дату окончания или включите No expiry. Для AI-запусков при необходимости откройте AI limits.
  4. Сохраните показанный ключ в защищённом файле или Secrets. После закрытия его значение нельзя получить повторно.

Settings меняет имя, разрешения, срок действия и AI-лимиты без выпуска другого ключа. При одновременном изменении JWS сохраняет ваш черновик и просит загрузить текущие настройки. Revoke key отзывает доступ. Истечение срока и отзыв проверяются заново при обращении к сервису, а не только при входе.

Разрешения

  • Servers: чтение или управление серверами. Управление включает создание, изменение ресурсов, запуск программ и платные опции.
  • Scripts и SSH Keys: отдельные права чтения и изменения библиотек. SSH Keys содержит только публичные ключи для входа на серверы.
  • AI Bridge: чтение каталога и истории либо запуск. Для запуска задаются максимум стоимости запроса, параллельность и частота. Ключ видит собственные AI-запросы; запуск разрешает получение собственного результата.
  • AI Mail: отдельные права чтения, работы с черновиками, отправки, управления ящиками и правилами, импорта и AI-проверки. AI-проверка сохраняет действующее согласие и дневной лимит ящика.

Ключ действует только в аккаунте, который его выдал. Он не заменяет вход владельца в Secrets, настройки passkey, управление API-ключами или подключение хостов. Для подключения почтовых транспортов, привязки агента и ручного решения неопределённой доставки нужен вход владельца.

Использовать ключ

Передавайте ключ в заголовке Authorization: Bearer …, не в URL. Пример использует переменную, уже загруженную из вашей защищённой конфигурации:

curl --fail --silent --show-error \
  -H "Authorization: Bearer $JWS_API_KEY" \
  https://console.jws.network/api/provisioning/servers

Серверные API находятся под /api/provisioning, библиотеки под /api/scripts и /api/keys, AI под /api/ai/v1, почта под /api/mail/v1. Методы записи используют те же проверки владельца, текущие версии и подтверждения, что и Console. Создание сервера, AI-запуск или отправка письма выполняют настоящее действие.

Для jws ai внешний ключ можно настроить через JWS_AI_API_KEY; поддерживаются новые общие и существующие AI-ключи. Управляемой VM или зарегистрированному JWS Agent отдельный ключ не нужен: они используют собственное удостоверение. Старые внешние клиенты Secrets не получают этим способом дополнительных прав.

Отзыв ключа и уже начатая работа

Отзыв, истечение срока или снятие разрешения блокируют новую отправку провайдеру. Уже отправленную платную работу нельзя отменить одним отзывом ключа: JWS сохраняет её исходный запрос и подтверждённый расход, чтобы завершить расчёт без повторного запуска. Существующие AI-ключи находятся в Existing AI keys; их значения и ограничения не переиздаются.

HTTP-справочник

Базовый адрес: https://console.jws.network. Общие API-ключи передаются только в Authorization: Bearer …. Куки входа в playground не используются. Все операции ниже сохраняют права, срок действия и ограничения ключа.

Метод и путьРазрешениеЧто делает
GET /api/provisioning/plansservers:readПланы серверов.
GET /api/provisioning/applicationsservers:readКаталог программ.
GET /api/provisioning/serversservers:readСерверы своего аккаунта.
GET /api/provisioning/servers/{serverId}servers:readСостояние одного сервера.
GET /api/provisioning/servers/{serverId}/metricsservers:readРеальная статистика сервера.
GET /api/scriptsscripts:readБиблиотека скриптов.
GET /api/scripts/{scriptId}scripts:readСкрипт своего аккаунта.
GET /api/keysssh-keys:readПубличные SSH Keys.
GET /api/ai/v1/modelsai:readКаталог моделей. Полученный modelId используется в остальных запросах.
GET /api/ai/v1/models/{modelId}ai:readКонтракт модели: inputSchema, outputSchema, тарифы.
GET /api/ai/v1/requestsai:readИстория собственных запросов API-ключа.
GET /api/ai/v1/requests/{requestId}ai:read или ai:runСостояние и результат ранее запущенного запроса.
GET /api/ai/v1/usageai:readФактические расходы.
POST /api/ai/v1/quotesai:runПроверка входных данных и получение quote без отправки провайдеру.
POST /api/ai/v1/models/{modelId}/runai:runНастоящий платный запуск. Сначала получите quote; input обязан соответствовать модели.
POST /api/ai/v1/requests/{requestId}/cancelai:runЗапросить отмену известной работы. Отмена не гарантирует возврат стоимости.
GET /api/mail/v1/mailboxesmail:readПочтовые ящики аккаунта.
GET /api/mail/v1/mailboxes/{mailboxId}mail:readСостояние почтового ящика.
GET /api/mail/v1/mailboxes/{mailboxId}/messagesmail:readСписок писем.
GET /api/mail/v1/mailboxes/{mailboxId}/messages/{messageId}mail:readПисьмо, доступное вашему ключу.

Имена в фигурных скобках замените настоящими ID из предыдущего ответа. 400 — неверный формат; 401 — ключ отсутствует, отозван или истёк; 403 — нет нужного права; 404 — объект недоступен; 409 — конфликт состояния; 429 — лимит; 503 — сервис временно недоступен. Ответ 202 означает принятую работу, а не её завершение.

Playground

Вставьте свой ключ, выберите операцию и отправьте один запрос. Ключ живёт только в памяти этой страницы: мы не записываем его в URL, localStorage, аналитику или сервер документации. Ответы могут содержать ваши данные; закрывайте страницу после работы.

Создать ключ ↗

Iron Shield

Отдельная асинхронная проверка полного текста на prompt injection и бинарных файлов антивирусом. Текст, файлы и context не возвращаются в Console: раздел Iron Shield показывает только результаты и метаданные. AI-проверка выбирается для каждого нового запроса: укажите checks.injection: true. Общего переключателя нет; в Settings задаётся дневной лимит от1 до100 проверок, верхняя граница — $0.02 за проверку. Антивирус не требует платной AI-проверки.

POST /api/iron-shield/checks с правом shield:check и постоянным Idempotency-Key возвращает ID. GET /api/iron-shield/checks и GET /api/iron-shield/checks/{checkId} требуют shield:read. Проверяйте поле decision: завершённый succeeded может содержать quarantine. Unknown, неполная антивирусная проверка или недоступный scanner никогда не означают safe.

Полный текст ≤3000 UTF-8 байт, context ≤512 байт, text/context и извлечённые материалы вместе ≤4096 байт до добавления системных вопросов и serviceContext. До20 файлов с полем dataBase64, каждый ≤5MiB, суммарно ≤8MiB, JSON ≤12MiB. С checks.injection: true проверяется текст запроса, читаемые UTF-8/HTML файлы и их содержимое в ZIP, текст и ссылки PDF, а также до3 публичных HTTPS-ссылок из исходных материалов: один уровень, не более2 перенаправлений. Файлы требуют и антивирусную проверку. PDF с изображениями, нечитаемые материалы, недоступные ссылки и превышенные пределы дают неполное покрытие, не safe; OCR не выполняется. Извлечённый текст фиксируется до AI-запуска и входит в предел4096 байт материалов, без скрытого обрезания. Полные запросы с вопросами и serviceContext отдельно проверяются по подтверждённой цене до платного допуска. В Console есть ручная проверка текста и файлов; AI выбирается отдельно в каждой форме. Не обрезайте исходный текст для обхода ограничений.

После потери ответа используйте тот же Idempotency-Key или опрос известного ID, не новую оплату. POST .../{checkId}/cancel и POST .../{checkId}/recover принимают {}; cancel не обещает отмену уже принятого upstream запуска/возврат, recover только сверяет известный receipt, без повторного scanner/model запуска. Terminal содержимое удаляется; результат safe заново не реконструируется. История30 дней, активная заявка24 часа; списки используют nextCursor.

Новые AI-проверки двухступенчатые: OpenAI Decisions с GPT-6 Luna быстро классифицирует полное извлечённое содержимое; неоднозначность, подозрение на инъекцию или чувствительный запрос без достаточного контекста передаются поддерживаемой более сильной модели OpenAI. Простая повелительная фраза — не самостоятельная причина карантина. Высокая уверенность первого этапа не заменяет проверку полноты материалов. Оба этапа имеют один общий предел $0.02 и одну дневную попытку. Потерянный ответ платного этапа не запускает следующий этап и не разрешает повторную оплату.

Сервис может добавить serviceContext: version:1, senderRelationship (known/unknown), senderAuthentication (verified/unknown/failed), priorCorrespondenceCount (0..100), threadEstablished (boolean), clientAffiliation (known/unknown), workspaceSensitivity (public/internal/confidential/financial/unknown), expectedRequest (boolean/null). Передавайте только факты, которыми сервис действительно располагает. Если данных нет, укажите unknown/null, не делайте вывод из самого письма. Происхождение контекста назначает сервис; клиент не может выдать свои поля за историю Mail. Контекст помогает оценить риск, но не разрешает отправку письма, раскрытие данных или исполнение инструкций. Mail заполняет известные ему поля из сохранённых контактов и переписки.

Результат содержит result.review с этапом, признаком подробного разбора и метаданными подтверждённых этапов — без исходного текста. cost.totalCostMicros — итог только при подтверждённых расходах всех запущенных этапов; при неизвестном исходе он null. confirmedCostMicros — подтверждённая часть, не итоговая цена. Старые задания продолжают исходный зафиксированный сценарий, без перезапуска.

Правила и примеры проверены 11 октября 2026. Актуальные цены и доступность приложений смотрите в консоли.