Постмортемы
В этой статье мы рассмотрим структуру объекта Постмортема и способы управления им через API. Постмортем содержит подробный анализ причин и последствий завершенного инцидента. Он помогает пользователям понять, что произошло, как это было исправлено и какие меры предпринимаются для предотвращения подобных инцидентов в будущем.
Объект Постмортема
GET /v1/pages/{page_id}/incidents/{incident_id}/postmortem
Этот метод возвращает объект Постмортема, связанный с указанным инцидентом. Если постмортем для данного инцидента не был создан, API вернет ошибку 404 Not Found.
Пример объекта Постмортема:
{
"body": "### Это демо постмортема \n\nБыл демонстрационный инцидент. Здесь мы покажем как выглядит Постмортем. \n\n```\nЭто какой-то код\n```",
"body_draft": "### Это демо постмортема \n\nБыл демонстрационный инцидент. Здесь мы покажем как выглядит Постмортем. \n\n```\nЭто какой-то код\n```",
"body_draft_updated_at": "2025-05-08T16:32:41.305388",
"body_updated_at": "2025-05-08T16:32:41.366783",
"created_at": "2025-05-08T16:32:41.310333",
"id": "xwmmhqrtfy9c",
"incident_id": "2wfcdej9nyuv",
"notify_subscribers": true,
"preview_key": null,
"published_at": "2025-05-08T16:32:41.366790",
"updated_at": "2025-05-08T16:32:41.368279"
}
Поля
| Поле | Тип объекта | Описание |
|---|---|---|
body | string or null | Опубликованное содержание постмортема. Может содержать Markdown. |
body_draft | string or null | Содержание черновика постмортема. Может содержать Markdown. |
body_draft_updated_at | string (ISO 8601) | Дата и время последнего обновления черновика постмортема. |
body_updated_at | string (ISO 8601) | Дата и время последнего обновления опубликованного содержания постмортема. |
created_at | string (ISO 8601) | Дата и время создания объекта постмортема. |
id | string | Уникальный идентификатор постмортема. |
incident_id | string | ID инцидента, к которому относится данный постмортем. |
notify_subscribers | boolean | Указывает, нужно ли уведомлять подписчиков при публикации постмортема. |
preview_key | string or null | Текст предпросмотра постмортема. |
published_at | string (ISO 8601) | Дата и время публикации постмортема. Если постмортем еще не опубликован, это поле будет null. |
updated_at | string (ISO 8601) | Дата и время последнего обновления объекта постмортема. |
Создание и обновление Постмортема
PUT /v1/pages/{page_id}/incidents/{incident_id}/postmortem
Используйте этот метод для создания постмортема для указанного инцидента.
Требуемые поля
| Поле | Тип объекта | Описание |
|---|---|---|
body_draft | string or null | Содержание черновика постмортема. Может содержать Markdown. |
Опубликовть Постмортем
PUT /v1/pages/{page_id}/incidents/{incident_id}/postmortem/publish
Вызов этого эндпоинта копирует body_draft в body, выставляет published_at в now.
Опубликованные Постмортемы видны в объекте Инцидента.