AT AppointmentTrader
Iniciar sesión
En línea ahora  
Partner Programs Integración API · REST público

Llamar a AT
desde cualquier lugar.

Una superficie REST autenticada para cada reserva, oferta, transacción y lugar en AppointmentTrader. HTTPS simple, JSON de entrada y salida, errores predecibles — los mismos endpoints que alimentan la app web de AT, disponibles para tus servidores.

Leer la documentación Obtener una clave API
  • 120+endpoints públicos
  • 99.9%disponibilidad, últimos 12 meses
  • <120mslatencia p95, edge
curl · cualquier lenguaje JavaScript SDK Python SDK PHP SDK REST · JSON API key · HMAC Webhooks · signed
Cómo funciona

Tres pasos. Una clave. Cinco minutos para la primera llamada.

  1. 01

    Obtener una clave API

    Gratis, instantáneo, con alcance. Los endpoints públicos funcionan sin clave; los endpoints con alcance de usuario necesitan clave API y permiso por usuario. Sin vendedor, sin lista de espera — el formulario está en /api-documentation.

  2. 02

    Usa /v1/...

    HTTPS simple, JSON de entrada y salida, errores predecibles. Todo lo que usa la app web de AppointmentTrader está aquí, documentado, con ejemplos de solicitudes y esquemas de respuesta. Sin gateway GraphQL, sin sorpresas de protocolo.

  3. 03

    ¿Necesitas una interfaz dentro de AT?

    Cambia de vía. La vía de desarrollo de apps envuelve tu app en el entorno AT — mismos endpoints, más SDK, entrada en barra lateral e instalación en portal.

Familias de endpoints

Seis superficies. Un contrato.

Referencia completa

Datos de mercado

Público
/v1/marketdata/get_world_top

Ciudades en tendencia, precios de cubierto, tasas de cumplimiento, transacciones recientes. La misma superficie que alimenta el cartel público de AT — compatible con SSR, tipado JSON, paginado.

Ofertas y demandas

Clave API
/v1/concierge/categorize_request

Envía una intención de compra, recibe una coincidencia de lugar analizada. Obtén ofertas abiertas, coloca una contraoferta, lanza una oferta. La misma forma usada por el compositor de intenciones en la app.

Transacciones

Clave API
/v1/transaction/list

Historial de transacciones autenticado por usuario, filtrado por estado, rango de fechas, ubicación. Suscripciones a webhooks para cambios de estado (pagado, transferido, reembolsado).

Ubicaciones

Público
/v1/location/search

Búsqueda de lugares, autocompletado, horarios, capacidad, fotos. La misma base de datos que alimenta la barra de búsqueda de AT — indexada en 12 categorías desde restaurantes hasta citas en la DGT.

Notificaciones

Clave API
/v1/notification/subscribe

Suscripciones push, email y SMS por usuario. Temas específicos (puja completada, transacción confirmada, mensaje recibido). Firma estándar de webhook en salida.

Usuario y social

Clave API
/v1/user/get_profile

Perfiles, valoraciones, gráfico de seguimiento, feeds de actividad. Solo lectura en la superficie pública; CRUD completo cuando se llama desde un iframe host de la app con un token SDK válido.

120+
endpoints públicos en seis superficies
99.9%
disponibilidad 12 meses, superficie pública y autenticada
<120ms
latencia p95 desde el edge, todas las regiones
$0
nivel gratuito, sin tarjeta de crédito para empezar
Preguntas frecuentes

Las respuestas honestas.

¿Cuánto cuesta?

Gratis para la superficie pública (datos de mercado, búsqueda de ubicación) con límites de uso justo. Los endpoints con ámbito de usuario — los que afectan a reservas reales — son gratis los primeros 10.000 llamadas al mes, luego medidos. Distribución host de app (tu app dentro de /apps/{id}/) is free; we revenue-share only on transactions you originate.

¿Cuáles son los límites de tasa?

60 req/min en la superficie pública, sin autenticar. 600 req/min con clave API. Los endpoints con ámbito de usuario tienen ventana deslizante por usuario; fallo suave al límite, fallo duro tras abuso sostenido. Cada respuesta incluye X-RateLimit-Remaining y X-RateLimit-Reset — no surprises.

¿Hay sandbox?

Sí. Añade ?sandbox=1 a cualquier endpoint, o usa la misma ruta en 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.

¿Soportan webhooks?

Sí — firmados con HMAC, reintentados con backoff, reproducibles desde el panel. Suscríbete por tema (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.

¿Cuándo debería cambiar a Desarrollo de Apps?

Cuando tus usuarios viven dentro de AppointmentTrader. API directa: tu app, tus servidores, tu distribución — los usuarios conceden acceso a tu clave API desde sus ajustes, tú llamas /v1/ desde un backend que posees. Desarrollo de 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.

¿Cómo consigo una clave?

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

Tu código, nuestro marketplace. Empieza en cinco minutos.

Nivel gratuito. Sin tarjeta de crédito. Sin llamada de ventas. La misma superficie que alimenta todo lo que ves en AppointmentTrader.

Leer la documentación Back to Partner Programs

Más de 120 endpoints públicos. 99,9% de disponibilidad. p95 bajo 120ms.