Перші кроки

У цьому посібнику ти створиш тікет через REST API v1, прочитаєш його статус і додаси коментар. Тобі знадобляться curl та API-ключ.

1. Створи API-ключ

Адміністратор твого тенанта створює ключ в exoCortex Core, у Integrations → API keys, зі scope tickets:create, tickets:read і tickets:comment. Ключ показується лише один раз: збережи його в змінній середовища, не записуючи в код.

export EXO_API_KEY='nhk.<keyid>.<secret>'

Подробиці — у розділі API-ключі.

2. Створи тікет

curl -X POST "https://exocortex-api.ai-exo-cortex.com/api/v1/tickets" \
  -H "Authorization: Bearer $EXO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
    "subject": "Payment gateway returns HTTP 502",
    "description": "Checkout fails for all EU customers since 09:12 UTC.",
    "priority": "High",
    "external_id": "INC-88231"
  }'

Відповідь містить ключ тікета й адресу, за якою можна прочитати його статус:

{
  "ok": true,
  "ticket_key": "ACME-1042",
  "action": "created",
  "status_url": "/api/v1/tickets/ACME-1042"
}

Тенант вказувати не треба: це тенант ключа. Idempotency-Key захищає від дублікатів: якщо повториш той самий запит із тим самим ключем ідемпотентності, отримаєш той самий тікет з action: deduplicated. Через external_id ти зберігаєш посилання на запис у своїй системі.

3. Прочитай статус

curl "https://exocortex-api.ai-exo-cortex.com/api/v1/tickets/ACME-1042" \
  -H "Authorization: Bearer $EXO_API_KEY"

{
  "ok": true,
  "ticket": {
    "key": "ACME-1042",
    "summary": "Payment gateway returns HTTP 502",
    "status": "In Progress",
    "priority": "High",
    "assignee": "Jane Doe",
    "created": "2026-11-01T09:14:05.000Z",
    "updated": "2026-11-01T09:31:47.000Z"
  }
}

Для тікета іншого тенанта відповідь — 404, так само як для тікета, якого не існує.

4. Додай коментар

curl -X POST "https://exocortex-api.ai-exo-cortex.com/api/v1/tickets/ACME-1042/comment" \
  -H "Authorization: Bearer $EXO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{ "comment": "Rollback completed, monitoring for 30 minutes." }'

5. Обробляй помилки й ліміти

Кожна помилка має ok: false і стабільний code, наприклад invalid_api_key або validation_error: будуй логіку на code.
У разі 429 зачекай стільки секунд, скільки вказано в Retry-After, перш ніж повторювати.
У разі помилки 5xx повтори запит із тим самим Idempotency-Key.

Повний перелік кодів — у розділі API-ключі.

Наступні кроки

Замість опитування статусу отримуй події через вихідні вебхуки.
Використовуй SDK, щоб не писати HTTP-виклики вручну.
Переглянь довідник Ticket, щоб побачити всі поля.