AT AppointmentTrader
Se connecter
En ligne  
Partner Programs Intégration API · REST public

Appelez AT
de partout.

Une surface REST authentifiée pour chaque réservation, offre, transaction et lieu sur AppointmentTrader. HTTPS simple, JSON entrant et sortant, erreurs prévisibles — mêmes endpoints que l'app web AT, disponibles pour vos serveurs.

Lire la doc Obtenir une clé API
  • 120+endpoints publics
  • 99.9%disponibilité, 12 derniers mois
  • <120mslatence p95, edge
curl · tous langages JavaScript SDK Python SDK PHP SDK REST · JSON API key · HMAC Webhooks · signed
Comment ça marche

Trois étapes. Une clé. Cinq minutes avant le premier appel.

  1. 01

    Obtenir une clé API

    Gratuit, instantané, limité. Les endpoints publics fonctionnent sans clé ; les endpoints utilisateur nécessitent clé API et autorisation par utilisateur. Pas de commercial, pas de liste d'attente — le formulaire est à /api-documentation.

  2. 02

    Tapez /v1/...

    HTTPS simple, JSON entrant et sortant, erreurs prévisibles. Tout ce que l'app web AppointmentTrader utilise est ici, documenté, avec exemples de requêtes et schémas de réponse. Pas de passerelle GraphQL, pas de surprise de protocole.

  3. 03

    Besoin d'une interface dans AT ?

    Changez de voie. La voie développement d'apps intègre votre app dans le shell AT — mêmes endpoints, plus SDK, entrée barre latérale, installation portail.

Familles d'endpoints

Six interfaces. Un contrat.

Référence complète

Données de marché

Publique
/v1/marketdata/get_world_top

Villes tendance, prix moyens, taux de remplissage, transactions récentes. Même surface que la vitrine publique AT — SSR-friendly, typée JSON, paginée.

Offres & demandes

Clé API
/v1/concierge/categorize_request

Soumettez une intention d'achat, obtenez une correspondance de lieu analysée. Récupérez les offres ouvertes, placez une contre-offre, déposez une offre. Même format que le compositeur d'intentions in-app.

Transactions

Clé API
/v1/transaction/list

Historique des transactions authentifié par utilisateur, filtré par statut, date, lieu. Abonnements webhook pour changements d'état (payé, transféré, remboursé).

Lieux

Publique
/v1/location/search

Recherche de lieux, autocomplétion, horaires, capacité, photos. Même base que la barre de recherche AT — indexée sur 12 catégories de restaurants à DMV.

Alertes

Clé API
/v1/notification/subscribe

Abonnements push, email, SMS par utilisateur. Thématiques (enchère remplie, transaction confirmée, message reçu). Signature webhook standard à la sortie.

Utilisateur & social

Clé API
/v1/user/get_profile

Profils, évaluations, graphe de suivi, flux d'activité. Lecture seule en surface publique ; CRUD complet depuis un iframe hébergeant l'app avec un token SDK valide.

120+
points d’accès publics sur six surfaces
99.9%
Disponibilité 12 mois, surface publique & authentifiée
<120ms
Latence p95 depuis le edge, toutes régions
$0
offre gratuite, sans carte bancaire au démarrage
FAQ

Les réponses honnêtes.

Quel est le coût ?

Gratuit pour la surface publique (données marché, recherche de lieu) avec des limites d’usage équitables. Les endpoints liés à l’utilisateur — ceux qui touchent les réservations réelles — sont gratuits pour les 10 000 premières requêtes par mois, puis facturés. Distribution hébergée (votre app dans /apps/{id}/) is free; we revenue-share only on transactions you originate.

Quelles sont les limites de débit ?

60 req/min sur la surface publique, non authentifiée. 600 req/min avec une clé API. Les endpoints liés à l’utilisateur ont une fenêtre glissante par utilisateur ; échec doux à la limite, échec dur en cas d’abus prolongé. Chaque réponse contient X-RateLimit-Remaining et X-RateLimit-Reset — no surprises.

Y a-t-il un bac à sable ?

Oui. Ajoutez ?sandbox=1 à n’importe quel endpoint, ou utilisez le même chemin sur 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.

Supportez-vous les webhooks ?

Oui — signés HMAC, réessayés avec backoff, rejouables depuis le tableau de bord. Abonnement par sujet (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.

Quand devrais-je passer à App Development ?

Quand vos utilisateurs vivent dans AppointmentTrader. API directe : votre app, vos serveurs, votre distribution — les utilisateurs accordent l’accès à votre clé API depuis leurs paramètres, vous appelez /v1/ depuis un backend que vous possédez. Développement d'apps: 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.

Comment obtenir une clé ?

/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).

Votre code, notre marketplace. Commencez en cinq minutes.

Offre gratuite. Pas de carte bancaire. Pas d’appel commercial. La même surface qui alimente tout ce que vous voyez sur AppointmentTrader.

Lire la doc Back to Partner Programs

120+ endpoints publics. 99,9 % de disponibilité. p95 sous 120ms.