POST /api/v1/tickets

Статус: GA Доступ: по токену контракт API: 0.3.0 · capability 2026-09-03.1 Открыть как Markdown Открыть в Claude Открыть в ChatGPT

File Ticket

Intake one report; return a bare 202.

Write-only fire-and-forget: no ticket id, no dedup verdict — a hostile or looping reporter gets nothing back to react to. Over the flood cap → 429; an oversized body → 413.

Авторизация: нужен Authorization: Bearer <token>

Запрос

curl -sS -X POST "https://entherium.duckdns.org:8443/api/v1/tickets" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"actual":"The Description column is empty","component":"portal","environment":{"commit":"dcaf59d1"},"evidence":[{"type":"url","url":"https://enterium-developer-docs.pages.dev/developers/mcp/tools/entherium_create_task/"}],"expected":"Every parameter has a description","kind":"defect","severity":"sev3","steps_to_reproduce":["Open /developers/mcp/tools/entherium_create_task/","Look at the Parameters table"],"title":"Tool page renders an empty Description column"}'

Ответ `202`

В контракте нет примера для этого ответа; схема: object. Поля — в интерактивном обозревателе.

Возвращает

object — Successful Response

Параметры

Параметр	Где	Обязателен	Тип	По умолчанию	Ограничения	Описание
`Idempotency-Key`	header	нет	`string`	—	uuid	Optional.

Тело запроса

Поле	Тип	Обязательно
`actual`	`string \| null`	нет
`alternatives`	`массив string \| null`	нет
`area`	`string \| null`	нет
`behavior_cases`	`массив string \| null`	нет
`body`	`string \| null`	нет
`component`	`string \| null`	нет
`contract_guid`	`integer \| null`	нет
`environment`	`object \| null`	нет
`evidence`	`массив EvidenceItem \| null`	нет
`expected`	`string \| null`	нет
`expected_benefit`	`string \| null`	нет
`fingerprint`	`string \| null`	нет
`kind`	`string \| null`	нет
`payload`	`object \| null`	нет
`problem`	`string \| null`	нет
`proposed_change`	`string \| null`	нет
`run_guid`	`integer \| null`	нет
`severity`	`string \| null`	нет
`spec_ref`	`string \| null`	нет
`steps_to_reproduce`	`массив string \| null`	нет
`title`	`string`	да

Пример:

{
  "actual": "The Description column is empty",
  "component": "portal",
  "environment": {
    "commit": "dcaf59d1"
  },
  "evidence": [
    {
      "type": "url",
      "url": "https://enterium-developer-docs.pages.dev/developers/mcp/tools/entherium_create_task/"
    }
  ],
  "expected": "Every parameter has a description",
  "kind": "defect",
  "severity": "sev3",
  "steps_to_reproduce": [
    "Open /developers/mcp/tools/entherium_create_task/",
    "Look at the Parameters table"
  ],
  "title": "Tool page renders an empty Description column"
}

Ошибки

Код	Смысл	Тело
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

Тело любой ошибки — {detail, code?, request_id, doc_url}: request_id — что цитировать, doc_url ведёт в Справочник ошибок.