# Reference API pro výpadky

Source: https://instatus.com/help/cs/api/outages

## Získání všech výpadků stránky

**Endpoint:**

```bash
GET /v1/:page_id/outages?page=:page&per_page=:per_page
```

- Výchozí číslo stránky je 1.
- Výchozí hodnota per_page je 50, maximum je 100 položek na stránku.

**Ukázková odpověď:**

```json
[
  {
    "id": "ckoutage1",
    "from": "2020-09-12T03:38:47.998Z",
    "to": "2020-09-12T04:38:47.998Z",
    "status": "PARTIALOUTAGE",
    "visibilityState": "PUBLISHED",
    "createdAt": "2020-09-12T03:38:47.998Z",
    "updatedAt": "2020-09-12T03:40:47.998Z",
    "component": {
      "id": "ckf01fvnxywz50a35nh1qzssm",
      "name": "Website"
    },
    "incident": {
      "id": "ckf01m59ueaqb0a32wrljz1yd",
      "name": "Rocket is going down",
      "createdByType": "USER",
      "status": "INVESTIGATING"
    }
  }
]
```

## Získání výpadku

**Endpoint:**

```bash
GET /v1/:page_id/outages/:outage_id
```

**Ukázková odpověď:**

```json
{
  "id": "ckoutage1",
  "from": "2020-09-12T03:38:47.998Z",
  "to": "2020-09-12T04:38:47.998Z",
  "status": "PARTIALOUTAGE",
  "visibilityState": "PUBLISHED",
  "createdAt": "2020-09-12T03:38:47.998Z",
  "updatedAt": "2020-09-12T03:40:47.998Z",
  "component": {
    "id": "ckf01fvnxywz50a35nh1qzssm",
    "name": "Website"
  },
  "incident": {
    "id": "ckf01m59ueaqb0a32wrljz1yd",
    "name": "Rocket is going down",
    "createdByType": "USER",
    "status": "INVESTIGATING"
  }
}
```

## Přidání výpadku

**Endpoint:**

```bash
POST /v1/:page_id/outages
```

**Ukázkový požadavek:**

```json
{
  "componentId": "ckf01fvnxywz50a35nh1qzssm",
  "status": "PARTIALOUTAGE",
  "from": "2020-09-12 03:38:47.998",
  "to": "2020-09-12 04:38:47.998",
  "visibilityState": "PUBLISHED"
}
```

**Ukázková odpověď:**

```json
{
  "id": "ckoutage1",
  "from": "2020-09-12T03:38:47.998Z",
  "to": "2020-09-12T04:38:47.998Z",
  "status": "PARTIALOUTAGE",
  "visibilityState": "PUBLISHED",
  "createdAt": "2020-09-12T03:38:47.998Z",
  "updatedAt": "2020-09-12T03:40:47.998Z",
  "component": {
    "id": "ckf01fvnxywz50a35nh1qzssm",
    "name": "Website"
  },
  "incident": null
}
```

## Aktualizace výpadku

**Endpoint:**

```bash
PUT /v1/:page_id/outages/:outage_id
```

**Ukázkový požadavek:**

```json
{
  "status": "MAJOROUTAGE",
  "to": "2020-09-12 05:38:47.998"
}
```

**Ukázková odpověď:**

```json
{
  "id": "ckoutage1",
  "from": "2020-09-12T03:38:47.998Z",
  "to": "2020-09-12T05:38:47.998Z",
  "status": "MAJOROUTAGE",
  "visibilityState": "PUBLISHED",
  "createdAt": "2020-09-12T03:38:47.998Z",
  "updatedAt": "2020-09-12T04:40:47.998Z",
  "component": {
    "id": "ckf01fvnxywz50a35nh1qzssm",
    "name": "Website"
  },
  "incident": null
}
```

## Smazání výpadku

**Endpoint:**

```bash
DELETE /v1/:page_id/outages/:outage_id
```

**Ukázková odpověď:**

HTTP 204 No Content