yachtify.net
Служебный API по чартерным лодкам: опознание лодки по фразе человека, карточка лодки, компания, база. Только чтение, ответы в JSON.
Что внутри сейчас
| лодок | компаний | баз | отзывов |
|---|---|---|---|
| 17073 | 1856 | 916 | 10478 |
Числа берутся из базы в момент показа, а не вписаны в страницу.
Полнота каталога неизвестна, и мы говорим об этом первыми.
Выдача платформ устроена по ДОСТУПНОСТИ, а не по флоту: окно дат даёт свой срез и не является
надмножеством другого. Сколько лодок во флоте — выдача не сообщает в принципе.
Что именно измерено и на каких окнах, отдаёт
/v1/health.Ручки
| метод | путь | что делает |
|---|---|---|
GET | /v1/resolve?q= | фраза человека → лодка, компания, база |
GET | /v1/boats?q= | поиск лодок по имени или модели |
GET | /v1/boats/<id> | лодка: модель, год, оператор, база, цена, доступность |
GET | /v1/bases/<id> | база: страна, лодки |
GET | /v1/companies/<id> | чартерная компания и размер флота |
GET | /v1/health | состояние службы и ЧЕСТНАЯ полнота каталога |
Ключ
Каждый запрос к /v1/, кроме /v1/health, требует заголовок
X-Api-Key. Пределы — 60 запросов в минуту и 5000 в сутки, считаются по факту
запросов; при превышении приходит 429 с заголовком Retry-After.
curl -H "X-Api-Key: <ключ>" https://yachtify.net/v1/resolve?q=Bavaria+46+в+Кавасе
Ключи сейчас выдаются только проектам нашего флота. Публичной выдачи ключей нет — и пока её нет, мы этого не обещаем.