Обновление Инцидента

В этой статье разберем структуру объекта Обновления Инцидента (incident_updates), как их получить и как изменять. incident_updates — неотъемлемая часть Инцидентов. Рекомендуем прочитать предыдущую статью про управление Инцидентами.

Получение Обновлений Инцидента

GET /v1/pages/{page_id}/incidents/{incident_id}/incident_updates
GET /v1/pages/{page_id}/incidents/{incident_id}/incident_updates/{incident_update_id}

Метод для получения всех обновлений указанного инцидента или одного обновления по ID.

Пример массива объектов обновлений инцидента:

[
  {
    "body": "Ничего плохого не происходит, просто демонстрация.",
    "components": {
      "gnmsg97pjj3c": "partial_outage"
    },
    "created_at": "2025-05-01T10:02:53.629433",
    "deliver_notifications": false,
    "display_at": null,
    "id": "si78yj8ics6e",
    "incident_id": "7susdsaqfm6l",
    "status": "investigating",
    "updated_at": "2025-05-01T10:02:53.629438"
  }
]

Изменение Обновления Инцидента

PUT /v1/pages/{page_id}/incidents/{incident_id}/incident_updates/{incident_update_id}
PATCH /v1/pages/{page_id}/incidents/{incident_id}/incident_updates/{incident_update_id}

Используйте методы PUT или PATCH для частичного обновления существующего обновления инцидента по его ID.

Доступные для изменения поля

Поле	Тип объекта	Описание
body	string	Новый текст обновления инцидента.
created_at	string (ISO 8601)	Новая дата и время создания обновления инцидента. Это поле используется при расчете аптайма, поэтому его изменение может быть полезно при создании инцидентов в прошлом.

Примеры обновления

1. Изменение текста обновления инцидента:

curl -X PATCH \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.pingera.ru/v1/pages/5rs9dvpvyyp8/incidents/7susdsaqfm6l/incident_updates/si78yj8ics6e \
  -d '{
    "body": "Проблема локализована, работаем над устранением."
  }'

2. Изменение времени создания обновления инцидента:

curl -X PATCH \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.pingera.ru/v1/pages/5rs9dvpvyyp8/incidents/7susdsaqfm6l/incident_updates/si78yj8ics6e \
  -d '{
    "created_at": "2025-05-01T09:45:00"
  }'