Skip to main content
Whop va a retirar dos API antiguas. Ambas pasan a la API actual en 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 @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.
Si llamas a la API sin un SDK, envía 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.

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 prefijo plan_, 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 con POST /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 con POST /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 con page 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.