Claves de API y autenticación

Una clave de API permite que tu propio código, los SDK de Posty5, n8n y los asistentes de IA trabajen con tu cuenta de Posty5. Esta página explica cómo funcionan las claves, y las demás páginas para desarrolladores tienen un enlace aquí en lugar de repetirlo.

Obtén una cuenta de desarrollador

Las claves de API son una función de la cuenta de desarrollador. Mejorar la cuenta es gratis y se aplica al instante. No cambia tu plan ni tus créditos.

En el panel de Posty5, abre Configuración de la cuenta y elige Claves de API.
Elige Mejorar a cuenta de desarrollador. La página se vuelve a cargar con tus claves de API y las formas de conectarte a Posty5.

Abre Claves de API en el panel

Crea una clave

En Claves de API, elige Crear clave de API.
Ponle a la clave un nombre que indique dónde se usa, por ejemplo Formulario de contacto del sitio web. El nombre es solo para ti.
Elige su alcance de los registros (se explica más abajo) y elige Crear. La nueva clave aparece con un botón para copiarla.

Una clave no se muestra solo una vez. La lista muestra cada clave enmascarada, y su botón de copiar vuelve a copiar la clave completa cuando la necesites. Cambia el nombre de una clave o el alcance de sus registros desde sus acciones en la lista.

Envía la clave con cada solicitud

Envía la clave en este encabezado en cada solicitud a la API de Posty5 —

La API está en

Para comprobar una clave, llama a la ruta que la describe. Responde con la clave, su propietario, el plan y los créditos que la cuenta puede gastar. Una clave revocada o desconocida recibe 401.

curl https://api.posty5.com/api/api-key/current \
  -H "X-API-Key: YOUR_API_KEY"

Los SDK y los nodos de n8n usan la misma clave.

Cliente	Dónde va la clave	Más información
JavaScript / TypeScript	`new HttpClient({ apiKey: "YOUR_API_KEY" })`	npm-sdk
.NET	`new Posty5Options { ApiKey = "YOUR_API_KEY" }`	dotnet-sdk
n8n	La credencial Posty5 API, en su campo API Key	n8n-nodes

Elige qué puede ver una clave

Cada clave tiene un alcance de los registros. Define qué registros tuyos puede listar y editar la clave.

Alcance de los registros	Qué puede listar y editar la clave
Solo los registros creados con esta clave	Solo los registros que creó esta clave. Los registros que creaste en el panel o con otra clave quedan fuera de su alcance, así que dos integraciones nunca interfieren en el trabajo de la otra.
Toda mi cuenta	Todos los registros de tu cuenta, dondequiera que se hayan creado. Un asistente de IA suele necesitar esta opción, porque le preguntas por cosas que creaste tú mismo.

Una clave nueva empieza con Solo los registros creados con esta clave, igual que todas las claves creadas antes de que existiera este ajuste. Para cambiarlo, abre las acciones de la clave y elige Cambiar el alcance de los registros. El enlace MCP de una clave usa el alcance de los registros de esa clave.

Último uso y revocación de una clave

La columna Último uso muestra cuándo la clave hizo su última solicitud. Se actualiza como máximo una vez cada pocos minutos, así que una clave en uso constante puede parecer unos minutos atrasada.

Para revocar una clave, abre sus acciones en la lista, elige Revocar y confirma.

Deja de funcionar al instante. Cada app, script e integración que la usa recibe 401 en su siguiente solicitud.
Su enlace de asistente de IA (MCP) deja de funcionar en el mismo momento.
La revocación no se puede deshacer. Crea una clave nueva si vuelves a necesitar una.
Lo que la clave ya hizo se mantiene. Los registros que creó siguen en tu cuenta, y las publicaciones que programó se publican a tiempo, porque la publicación programada no usa la clave.

Créditos

Una llamada hecha con una clave de API cuesta exactamente lo mismo que la misma acción en el panel, y los créditos salen de la cuenta propietaria de la clave. El precio de cada acción figura en Créditos de funciones

Mantén tus claves seguras

Guarda las claves en un servidor. Nunca pongas una en una página web, una app móvil o un repositorio público, cualquiera que la lea puede actuar como tú.
Una clave no puede administrar claves. Crear, listar, renombrar y revocar claves solo funciona mientras tienes la sesión iniciada en Posty5, así que una clave filtrada no puede leer tus otras claves ni crear nuevas.
Para rotar una clave, crea una nueva, cambia tu integración a ella, comprueba que la fecha de Último uso de la nueva clave se actualiza y luego revoca la antigua.
Si una clave se filtra, revócala de inmediato y crea una nueva.