У всех клиентов один OAuth-доступ и один Public API. Skills и MCP — только разные адаптеры поверх этого контракта.
Архивы не содержат секретов. Контрольные суммы предназначены для автоматической проверки загрузок.
sha256:aa712f449f041ff07aaf56acb3726791177610bc731198087e3e570f93d91add
sha256:2e97d206ed7a8aa701b139b38eefac39049c330a36630a6c9dd5f3c813dd9d16
sha256:e59f1c8e35c18af009cac92496c251995a29261f8eebd8a749cb1947c6a85ad9
sha256:a0e48ac54b9678e298ceec6bb731e4bb9f7c8ffe370c2ec4a76b0efe31e53279
Все OAuth POST-запросы используют application/x-www-form-urlencoded. Клиент обязан передавать resource indicator.
POST https://api.textoslav.ru/oauth/device/authorization
Content-Type: application/x-www-form-urlencoded
client_id=textoslav-agent&scope=transcriptions%3Aread&resource=https%3A%2F%2Fapi.textoslav.ruОтвет содержит device_code, user_code, verification_uri_complete, expires_in и interval. Token endpoint поддерживает стандартные authorization_pending, slow_down, access_denied и expired_token.
POST https://api.textoslav.ru/oauth/token
Content-Type: application/x-www-form-urlencoded
grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Adevice_code&client_id=textoslav-agent&device_code=...&resource=https%3A%2F%2Fapi.textoslav.ruAccess token действует 30 дней. Refresh token действует до 90 дней, ротируется при обновлении и привязан к resource, scopes и выбранному workspace.
GET https://api.textoslav.ru/v1/me
Authorization: Bearer <access_token>POST https://api.textoslav.ru/oauth/token
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&client_id=textoslav-agent&refresh_token=...&resource=https%3A%2F%2Fapi.textoslav.ruПолный HTTP-контракт доступен в OpenAPI JSON и интерактивной API-документации.
Stdio-сервер публикует инструменты textoslav_me, textoslav_list_transcriptions, textoslav_get_transcription, textoslav_import_url, textoslav_upload_file, textoslav_get_status, textoslav_list_segments, textoslav_search_transcript и textoslav_download_export.
Клиент должен проверять issuer и resource https://api.textoslav.ru, запрашивать минимальные scopes и хранить токены только в защищённом локальном хранилище. Загрузка файла должна выполняться только по явному запросу пользователя.