Glosario

Términos y definiciones clave utilizados en ANKK APP y sus API, con enlaces a las guías correspondientes.

🏢 Marca (Brand)

El contenedor operativo principal que abarca las conexiones de SNS, los trabajos de publicación, los miembros del equipo y las claves API. Cada clave API está estrictamente vinculada a una sola marca.

Guías relacionadas: Crear una marca, API de marcas, Equipo y configuración

🔗 Conexión de SNS

Una conexión autenticada mediante OAuth o credenciales entre una marca y una cuenta de red social externa. Se identifica mediante un connection_id.

Guías relacionadas: Conectar cuentas de redes sociales, API de conexiones, Capacidades de SNS

📝 Contenido

Una unidad de publicación lógica dirigida a una conexión SNS específica, que contiene el texto del cuerpo, los medios, los hashtags, el tiempo programado y los parámetros de la plataforma.

Guías relacionadas: Redactar contenido, API de contenidos

⚙️ Tarea de publicación (Publish Job)

Un registro de ejecución asíncrona en segundo plano que permite seguir la entrega de un contenido a la red social de destino.

Guías relacionadas: Cola y estado de publicación, Errores y reintentos

📥 Contenido creado y contenido sincronizado

Contenido creado: Publicaciones creadas y programadas en ANKK APP. Se pueden volver a intentar si fallan y editar mientras están en cola.
Contenido sincronizado: Publicaciones históricas sincronizadas desde cuentas de redes sociales externas. Son de solo lectura y no se pueden editar ni volver a intentar en ANKK.
Guías relacionadas: Contenido publicado

⏳ Solicitud aceptada (HTTP 202 Accepted)

Indica que una solicitud superó la autenticación, la comprobación de cuotas y la validación del payload, y que se agregó a la cola. No confirma que la publicación ya se haya entregado (published).

Guías relacionadas: Cola y estado de publicación, Webhooks

🔑 Clave de idempotencia (Idempotency Key)

Un token único proporcionado por el cliente que garantiza reintentos seguros sin riesgo de publicaciones duplicadas en redes sociales externas.

Guías relacionadas: Manejo de errores, API de contenidos

⚠️ Se requiere reconexión o una acción del usuario

Se requiere reconexión (Reconnect Required): El token venció o se revocaron permisos; es necesario volver a autenticarse mediante OAuth.
Se requiere una acción del usuario (Requires User Action): El usuario debe completar una acción directamente en la aplicación de la plataforma externa, como aceptar nuevos términos.
Guías relacionadas: Errores y reintentos, Conectar cuentas de redes sociales

🔔 Webhook

Un evento HTTP POST en tiempo real firmado con HMAC-SHA256 y enviado a tu endpoint al finalizar una tarea.

Guías relacionadas: Referencia de webhooks