API for Developers

Quick start#

A single request provides the status of all services. The response is plain JSON, and the updated field tells you how fresh the data is.

curl -s https://comfort.stream/api/v1/status

curl -s https://comfort.stream/api/v1/status/telegram

All services#

A brief status for each service in the catalogue.

GEThttps://comfort.stream/api/v1/status

{
  "updated": 1790000000,
  "services": [
    {
      "slug": "vk",
      "name": "ВКонтакте",
      "color": "ok",
      "code": "ok",
      "live": false
    },
    {
      "slug": "telegram",
      "name": "Telegram",
      "color": "warn",
      "code": "spike",
      "live": true
    },
    {
      "slug": "sberbank",
      "name": "Сбербанк Онлайн",
      "color": "ok",
      "code": "ok",
      "live": false
    }
  ]
}

Single service#

The status of a single service and report counts over the past hour and 24 hours. Replace slug with the short name from the list at the bottom of the page.

GEThttps://comfort.stream/api/v1/status/<slug>

Unknown slug returns a 404 status code.

{
  "slug": "telegram",
  "name": "Telegram",
  "color": "warn",
  "code": "spike",
  "live": true,
  "since": 1789998200,
  "reportsHour": 214,
  "reportsDay": 1387
}

Colors and codes#

color is for status lights, code is for the exact status. See how each code appears on the site in the "Label" column.

• ok — operational
• warn — issues detected
• bad — down
• none — no data

Monitoring badges#

Add your website to monitoring in your account — we check it every 5 minutes from Moscow. Enabling a public page for the monitor generates a badge showing uptime percentage: you can embed it in a README or on your website.

GEThttps://comfort.stream/api/m/<id>/badge.svg

<a href="https://comfort.stream/m/k3f9q2x7">
  <img src="https://comfort.stream/api/m/k3f9q2x7/badge.svg" alt="uptime">
</a>

[![uptime](https://comfort.stream/api/m/k3f9q2x7/badge.svg)](https://comfort.stream/m/k3f9q2x7)

The monitor id is available in your account on the site card. The badge updates every 5 minutes and works only while the public page is enabled.

Rules#

1. 1No key required. A reasonable polling rate is no more than once per minute: data updates every 5 minutes anyway.
2. 2Responses are cached for one minute (Cache-Control: max-age=60): frequent requests return cached data. If there are too many requests from a single IP, we may rate-limit them.
3. 3If you display this data on your site, please provide a link to comfort.stream.
4. 4Data is an estimate, not the official stance of the services. Do not base financial or security-critical decisions on it.

List of services#

Click a name to open its status page.