La integración API completa es donde se generan las claves de API que autentican el acceso programático a su cuenta de Personyze — leer y escribir usuarios, catálogos, interacciones, placeholders e informes.
En el panel: Configuración › Integraciones › API completa.
Generar una clave
- Abra Configuración › Integraciones y haga clic en Gestionar en la tarjeta API completa.
- Genere una clave nueva y cópiela. Guárdela de inmediato — no hay forma de recuperar después el valor de una clave existente.
- Dé a cada integración su propia clave, para poder revocar una sin romper las demás.
Eliminar una clave surte efecto al instante: todo lo que aún la use empieza a recibir 401. Genere la sustituta y despliéguela antes de revocar la antigua.
Las contraseñas de Zapier y las claves de API completa son el mismo conjunto de claves. Una clave generada en cualquiera de las dos tarjetas aparece en ambas, y cualquiera de ellas autentica cualquier endpoint.
Cómo usarla
La autenticación es HTTP Basic sobre HTTPS — nombre de usuario api, contraseña su clave:
curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/account'Ese endpoint devuelve {"id": …} y no modifica nada, lo que lo convierte en la forma más barata de comprobar que una clave funciona.
Referencia completa
La documentación completa de la API está en la wiki para desarrolladores:
- Descripción general de la API REST — forma de las solicitudes, verbos HTTP, códigos de respuesta, convenciones.
- Claves de API — cómo enviar la clave, probarla, tipos de clave y cómo mantenerla segura.
- Parámetros de ruta de la solicitud — la sintaxis
where/order_by/limit/columnsque comparten todos los objetos. - Errores, límites y reintentos — códigos de estado, el tope de 1000 filas, las reglas de indexación y qué se puede reintentar sin riesgo.
- Crear una integración — qué endpoint hace qué, y los comportamientos que sorprenden.
Los objetos
- Usuarios — users, users_columns, user_lists, user_list_users, user_interests, do
- Catálogo — products, articles, products_interactions, products_stats
- Analítica — summary_actions, sessions_archive, events, forms
- Configuración — placeholders, actions, conditions, containers_grab_variable
Para la personalización en el servidor — preguntar a Personyze qué debe ver un visitante y mostrarlo usted mismo — consulte personalización y pruebas A/B en el servidor.
Relacionado
- Integración con Zapier — la vía sin código hacia la misma API.