Данные рынка
Публичная/v1/marketdata/get_world_top
Популярные города, цены, коэффициенты заполнения, последние сделки. Та же поверхность, что и в публичном маркере AT — SSR-совместимая, типизированная JSON, с пагинацией.
Partner Programs
Интеграция API · Публичный REST
Вызывать AT
Вызывать AT
откуда угодно.
Одна REST API с авторизацией для всех бронирований, ставок, транзакций и заведений на AppointmentTrader. Простой HTTPS, JSON на вход и выход, предсказуемые ошибки — те же эндпоинты, что и в веб-приложении AT, доступны вашим серверам.
curl · любой язык
JavaScript SDK
Python SDK
PHP SDK
REST · JSON
API key · HMAC
Вебхуки · signed
Как это работает
Три шага. Один ключ. Пять минут до первого вызова.
-
01
Получить API ключ
Бесплатно, мгновенно, с ограничениями. Публичные эндпоинты работают без ключа; эндпоинты с ограничением пользователя требуют API ключ и разрешение для каждого пользователя. Без менеджера по продажам, без листа ожидания — форма доступна по адресу /api-documentation.
-
02
Вызовите /v1/...
Простой HTTPS, JSON на вход и выход, предсказуемые ошибки. Всё, что использует веб-приложение AppointmentTrader, здесь, с документацией, примерами запросов и схемами ответов. Без GraphQL и неожиданных протоколов.
-
03
Нужен UI внутри AT?
Смените путь. Путь Разработки приложений оборачивает ваше приложение в оболочку AT — те же эндпоинты, плюс SDK, боковая панель и установка в портал.
Семейства эндпоинтов
Полная справка
Шесть поверхностей. Один контракт.
Ставки и предложения
API ключ/v1/concierge/categorize_request
Отправьте намерение купить, получите подходящее заведение. Получайте открытые ставки, делайте контрпредложения, сбрасывайте ставки. Та же структура, что и в компоновщике намерений в приложении.
Транзакции
API ключ/v1/transaction/list
Аутентифицированная история транзакций по пользователю, с фильтрами по статусу, дате, локации. Подписки на вебхуки для изменений статуса (оплачено, передано, возвращено).
Места
Публичная/v1/location/search
Поиск заведений, автозаполнение, часы работы, вместимость, фото. Та же база, что и в поисковой строке AT — индексирована по 12 категориям от ресторанов до DMV.
Уведомления
API ключ/v1/notification/subscribe
Подписки push, email, SMS на пользователя. Тематические (ставка заполнена, транзакция подтверждена, сообщение получено). Стандартная подпись webhook при выходе.
Пользователь и социальные сети
API ключ/v1/user/get_profile
Профили, рейтинги, граф подписок, ленты активности. Только для чтения на публичной поверхности; полный CRUD при вызове из iframe приложения с действительным SDK токеном.
120+
публичные конечные точки на шести поверхностях
99.9%
12-месячное время безотказной работы, публичная и аутентифицированная поверхность
<120ms
p95 задержка от edge, каждый регион
$0
бесплатный тариф, без кредитной карты для старта
Часто задаваемые вопросы
Честные ответы.
Сколько это стоит?
Бесплатно для публичной поверхности (рыночные данные, поиск по локациям) с ограничениями по справедливому использованию. Конечные точки, связанные с пользователем — те, что касаются реальных бронирований — бесплатны первые 10 000 вызовов в месяц, затем тарифицируются. Распространение через хост приложения (ваше приложение внутри /apps/{id}/) is free; we revenue-share only on transactions you originate.
Какие лимиты по скорости?
60 запросов в минуту на публичной поверхности без аутентификации. 600 запросов в минуту с API ключом. Конечные точки, связанные с пользователем, имеют скользящее окно на пользователя; мягкий отказ при достижении лимита, жесткий отказ при злоупотреблениях. Каждый ответ содержит X-RateLimit-Remaining и X-RateLimit-Reset — no surprises.
Есть ли песочница?
Да. Добавьте ?sandbox=1 к любому endpoint или используйте тот же путь на sandbox.appointmenttrader.com. Same shapes, same auth, fixture data — transactions don't move real money, notifications don't ship to real users, and you can reset the world from the partner dashboard.
Поддерживаете ли вы webhooks?
Да — с HMAC-подписью, повторными попытками с экспоненциальной задержкой, воспроизводимыми из панели. Подписка по темам (bid.filled, transaction.confirmed, message.received, etc.) with an API key plus a per-user grant. We deliver from a stable IP range you can allowlist; logs and replays live in the partner dashboard for 30 days.
Когда стоит перейти на App Development?
Когда ваши пользователи находятся внутри AppointmentTrader. Прямой API: ваше приложение, ваши серверы, ваше распространение — пользователи предоставляют доступ вашему API ключу из настроек, вы вызываете /v1/ с вашего backend. Разработка приложений: your app loads inside an iframe on AT, gets a sidebar entry, an SDK token auto-issued for the active user, and ships into the user's portal beside our own surfaces. Same endpoints, same data, different reach — pick by where your users already are.
Как получить ключ?
/api-documentation#auth. Sign in to AT, click Generate, copy the key. The first request can land 30 seconds later. There's no review queue for the public tier; user-scoped grants flip on per-app review (typically same-day).
Ваш код, наш маркетплейс. Начните за пять минут.
Бесплатный тариф. Без кредитной карты. Без звонков продажам. Та же поверхность, что и в AppointmentTrader.
Более 120 публичных конечных точек. 99.9% времени безотказной работы. p95 менее 120 мс.
