/yandex-webmaster

Расписание врачей (спецификация данных)

Это НЕ endpoint Webmaster API. Это спецификация формата данных, который владелец медицинского сайта должен реализовать на своём сервере. Яндекс периодически обращается к этому API для получения актуального расписания.

Endpoint на стороне сайта

GET /api/slots?page={N}

Требования к реализации

• HTTP 200 OK (без редиректов)
• Content-Type: application/json; charset=utf-8
• Минимум 3 RPS
• Ответ за ≤ 10 секунд
• Полный экспорт за ≤ 10 минут
• Макс. 500 врачей на страницу

Формат ответа

{
  "Total": 150,
  "Url": "https://example.com/api/slots?page=2",
  "DoctorList": [
    {
      "Id": 12345,
      "Price": 2500,
      "Slots": {
        "clinic_001": [
          {
            "AmenityIds": [1, 2],
            "StartTime": "2025-03-22T10:00:00+03:00",
            "FinishTime": "2025-03-22T10:30:00+03:00",
            "Data": {}
          }
        ]
      }
    }
  ]
}

Поля:

• Total — общее число врачей
• Url — ссылка на следующую страницу (пустая = последняя)
• DoctorList[].Id — ID врача
• DoctorList[].Price — цена приёма (опционально)
• DoctorList[].Slots — расписание по клиникам
  • Ключ — ID клиники
  • StartTime/FinishTime — ISO 8601 с таймзоной
  • AmenityIds — ID удобств (опционально)

Скилл

Для этой спецификации нет скрипта в скилле, так как это не API Вебмастера, а требования к API на стороне владельца сайта.