{
  "service": "esim-competitor-prices",
  "auth": "Authorization: Bearer <API_KEY> (или ?key=<API_KEY>)",
  "endpoints": {
    "GET /v1/prices?region=BR": "Цены конкурентов из последнего успешного ежедневного сбора по направлениям, которые мы продаём (status: fresh — обновлены за 30 ч, stale — остались цены прошлых суток). Параметры: dest=US,ES · competitor=airalo,holafly · max_age_hours=N (отсечь старше N часов)",
    "GET /v1/prices/MX": "То же, регион в пути (id, название или алиас: BR, brasil, бразилия, MX, mexico…)",
    "GET /v1/prices?region=BR&view=summary": "Сводка: по каждому направлению и конкуренту — мин. цена, мин. цена за GB, безлимит на 7 дней",
    "GET /v1/history?region=BR&dest=US&days=30": "Дневная история минимальной цены и цены за GB по конкурентам",
    "GET /v1/regions": "Рынки, конкуренты, есть ли парсер, последние сборы",
    "POST /v1/regions": "Добавить рынок/конкурентов: {\"id\":\"KZ\",\"name\":\"Казахстан\",\"currency\":\"KZT\",\"competitors\":[\"Airalo\",\"Yesim\"]}",
    "POST /v1/refresh": "Запустить сбор сейчас: {\"region\":\"BR\"} или {\"region\":\"BR\",\"competitor\":\"airalo\"} (так же запускает ежедневная крон-задача)",
    "POST /v1/retry": "Повторить сегодняшние упавшие сборы (один раз; так же запускает крон-задача через 3 часа после ежедневной)"
  }
}