https://api.whop.com/api/v1, con las mismas claves de API.
Cambia a la API actual
1
Conserva tu clave de API
La API actual usa las mismas claves de API de cuenta y de app. Si una solicitud devuelve
403, a la clave le falta el permiso que necesita ese endpoint. Añádelo en Developer → API keys, o solicítalo en los permisos de tu app.2
Instala el SDK y fija una versión
Los SDK oficiales llaman a la API actual y envían la versión de la API con la que se construyeron. Si usas Si llamas a la API sin un SDK, envía
@whop/api, reemplázalo por @whop/sdk. Sus helpers withUser y withCompany no tienen equivalente: pasa el ID de usuario o de cuenta en cada solicitud.Api-Version-Date en cada solicitud. Versiones de la API explica cómo fijar una versión.3
Reemplaza cada llamada
Usa la pestaña de la API que estás abandonando y luego elimina la URL base o el paquete antiguos de tu código.
- API v2
- GraphQL pública
Encuentra tus llamadas a v2
Cada respuesta de v2 incluye tres encabezados:Registra las respuestas que incluyan
Deprecation para encontrar todas las llamadas a v2 que tu integración sigue haciendo.Mapa de rutas
Membresías y licencias
Miembros y clientes
Pagos y checkout
Productos y planes
Los planes ahora se llaman variantes. Los ID de variante conservan el prefijoplan_, por lo que los ID almacenados siguen funcionando.Cuenta, experiencias, reseñas y webhooks
Qué cambió respecto a v2
Actualizaciones parciales
v2 actualizaba un recurso conPOST /resource/{id}. La API actual usa PATCH /resource/{id} y solo cambia los campos que envías.Claves de licencia
validate_license de v2 comprobaba una clave y la vinculaba a una máquina en una sola llamada. En la API actual, tu servidor obtiene la membresía por clave de licencia, comprueba su status y escribe un ID de hardware en metadata la primera vez que alguien usa la clave. La guía de SaaS tiene el ejemplo completo.Mantén estas llamadas en tu servidor. La clave de API de tu cuenta puede modificar cualquier membresía de tu negocio, así que nunca la incluyas dentro de software descargable.Webhooks en el formato v2
Los webhooks creados a través de v2 siguen enviando payloads en formato v2. Para recibir el formato actual, crea un nuevo webhook desde el panel o conPOST /webhooks, traslada tu manejador a él y luego elimina el webhook de v2. Webhooks cubre las comprobaciones de firma y los tipos de evento.Paginación
v2 paginaba conpage y per y devolvía pagination.current_page y pagination.total_page. Las listas de la API actual devuelven un array data y un objeto page_info. Pasa first para establecer el tamaño de página y after con el page_info.end_cursor anterior para obtener la página siguiente. Detente cuando page_info.has_next_page sea false. Los SDK paginan por ti.
Próximos pasos
Versiones de la API
Fija una versión para que los cambios posteriores nunca rompan tu integración.
Webhooks
Verifica firmas, gestiona el formato de eventos actual y recibe mensajes de chat en lugar de sondear.
Gestiona membresías
Cancela, pausa, extiende y actualiza membresías.
Vistas de app
Comprueba el acceso de los miembros en las vistas de experiencia y de panel.

