PlusVibeAPIPlusVibeAPI

Технические обращения через API

POST /v1/technical-feedback — как передать техническую проблему по API PlusVibe: поля, request ID, дедупликация и статус обращения.

Используйте этот API, чтобы передать воспроизводимую техническую проблему: ошибку API, сбой интеграции, неожиданное поведение или деградацию производительности. Обращение привязано к аккаунту API-ключа; его может прочитать только тот же клиент.

Создать обращение

POSThttps://plusvibeapi.ru/v1/technical-feedback
ПараметрТипОписание
categorystringОбязательное: api_error, performance, incorrect_response, integration, feature_request или other.
summarystringОбязательное краткое описание: от 3 до 200 символов.
detailsstringОбязательные детали для воспроизведения: от 10 до 4 000 символов.
requestIdsstring[]Необязательно, до 10 ID запросов. Каждый ID должен принадлежать вашему аккаунту.
clientIncidentIdstringНеобязательный стабильный ID серии на вашей стороне (до 100 символов: буквы, цифры, ., _, :, -).
curl https://plusvibeapi.ru/v1/technical-feedback \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "api_error",
    "summary": "Unexpected 502 when creating a response",
    "details": "The request failed twice at 12:14 MSK. Retrying after 30 seconds did not help.",
    "requestIds": ["req_123"],
    "clientIncidentId": "checkout-api-20260727"
  }'

Ответ

{
  "deduplicated": false,
  "incident": {
    "id": "incident_abc123",
    "category": "api_error",
    "summary": "Unexpected 502 when creating a response",
    "requestIds": ["req_123"],
    "clientIncidentId": "checkout-api-20260727",
    "status": "manual_review",
    "occurrences": 1,
    "lastSeenAt": "2026-07-27T09:14:00.000Z",
    "createdAt": "2026-07-27T09:14:00.000Z"
  }
}

Новое обращение возвращает 201. Повтор активной серии возвращает 200 и deduplicated: true; поле occurrences увеличивается.

Проверить статус

GEThttps://plusvibeapi.ru/v1/technical-feedback/{id}
curl https://plusvibeapi.ru/v1/technical-feedback/incident_abc123 \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"

Ответ содержит объект incident с теми же полями. Чужой или неизвестный ID возвращает 404.

Ограничения и безопасность

Передавайте только техническое описание. Не включайте API-ключи, пароли, токены или полные заголовки авторизации. Сервис дополнительно редактирует секреты, но это не заменяет безопасную передачу данных.

API не меняет баланс, цены, доступ, ключи, данные, конфигурацию и не запускает деплой или перезапуск. Такие запросы отклоняются. Предложения по улучшению принимаются как feature_request и требуют ручного рассмотрения.

← ПредыдущийСправочник APIСледующий →Режим рассуждений