API для разработчиков
Автоматизируйте Papyro из ваших собственных систем
Версионированный REST API со спецификацией OpenAPI 3.1, API-ключами ограниченной области действия и идемпотентностью — а также MCP-сервер, чтобы AI-ассистенты могли работать внутри вашего рабочего пространства.
Версионированный REST API
Стабильная поверхность /api/v1 для досок, списков, карточек (с комментариями), заметок, пространств, клиентов и обращений хелпдеска, а также собственных заявок ваших конечных пользователей — документированная написанной вручную спецификацией OpenAPI 3.1, которую ваша установка отдаёт сама.
MCP-сервер для AI-ассистентов
Любой MCP-клиент может читать и изменять ваши доски и заметки через 12 инструментов — получать список, создавать и обновлять карточки (перемещать, назначать, добавлять метки), создавать списки, читать и писать заметки, а также разбирать отпечатки ошибок. Аутентификация через OAuth 2.1 (ваша установка сама является сервером авторизации) или ключ papyro_ с ограниченной областью действия. Каждый вызов фиксируется в аудите, а один переключатель администратора отключает всех клиентов сразу.
API-ключи с областями
Создавайте ключи papyro_ в Настройках, отправляйте их как токен Bearer или заголовок x-api-key и предоставляйте каждой интеграции только нужные ей области.
Приём ошибок на доски
Направьте свои сервисы на /api/v1/boards/{id}/fingerprints, и Papyro сгруппирует события, отследит первое и последнее появление, вызовет ваш webhook и может записать анализ первопричины прямо на карточку. Собственный мониторинг ошибок на вашем собственном сервере.
Идемпотентность и пагинация
Курсорная пагинация и ключи идемпотентности делают массовые и повторные запросы безопасными и предсказуемыми.
Видимые лимиты запросов
Каждый ответ содержит заголовки лимита запросов, поэтому ваш клиент всегда знает своё положение.
Полный интерактивный справочник API поставляется внутри каждой установки Papyro по адресу /api/v1/docs, а исходная спецификация доступна по /api/v1/openapi.json. Эндпоинт MCP находится по адресу /api/mcp и объявляет себя через стандартные документы обнаружения OAuth.