Saltar al contenido principal
Las claves API permiten el acceso seguro y programático a la plataforma unificada de medios minoristas de Toppie. Tanto si automatiza la gestión de campañas, crea paneles personalizados o integra datos de Toppie en flujos de trabajo existentes, las claves API proporcionan la base para escalar las operaciones de medios minoristas más allá de la interfaz de usuario.
Las claves Toppie y API proporcionan autenticación segura basada en tokens para el acceso programático a todos los endpoints Toppie. Esto permite la automatización de la gestión de campañas, la integración de datos y los flujos de trabajo de informes personalizados.

​
Beneficios clave

Automatizar las operaciones de campaña

Crea flujos de trabajo que creen, gestionen y optimicen campañas en múltiples minoristas sin intervención manual.

Integraciones personalizadas

Conecte los datos de Toppie a herramientas de BI, paneles de informes o sistemas internos para obtener análisis unificados de medios minoristas.

Control de acceso seguro

Los permisos basados en roles garantizan que los miembros del equipo solo accedan a los datos y las funcionalidades que necesitan.

​
Creando claves API

1

Navegue a Configuración

Acceda a Ajustes en la navegación del panel de control de Toppie.
2

Seleccionar API Integración

Seleccione API Integración en el menú de navegación de la izquierda.
3

Crear nueva clave

Haz clic en el botón ”+ Nueva clave API” para generar una nueva clave.
4

Ahorra inmediatamente

Copie y guarde su clave API inmediatamente; solo se mostrará una vez por motivos de seguridad.
5

Almacenamiento seguro

Almacena tu clave API en un lugar seguro, como un gestor de contraseñas o un sistema de gestión de secretos.
Toppie API Integration interface showing the New API Key button

​
Usando las claves API

Incluya su clave API en los encabezados de solicitud para la autenticación al realizar llamadas a Toppie API.

​
Encabezado de autenticación

curl -X GET https://api.topsort.com/toppie/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

​
Puntos de conexión API disponibles

Acceda a la funcionalidad completa a través de Toppie API:
  • Gestión de catálogos de productos - Cargar, actualizar y gestionar catálogos de productos
  • Operaciones del ciclo de vida de la campaña - Crear, modificar y supervisar campañas
  • Análisis e informes avanzados - Acceda a datos de rendimiento detallados
  • Gestión de presupuestos y licitaciones - Asignación y optimización programática del presupuesto

​
Documentación de API

Para obtener la documentación de referencia completa de api, visite la toppie api Reference. La documentación incluye:
  • Especificaciones y parámetros del punto final
  • Ejemplos de solicitud/respuesta
  • Directrices para el manejo de errores
  • Información que limita la velocidad
  • Ejemplos de SDK en varios idiomas

​
Mejores prácticas de seguridad

Directrices de seguridad Nunca compartas las claves API en repositorios de código ni en canales públicos.
  • Rote las llaves regularmente para mayor seguridad
  • Utilice variables de entorno o bóvedas seguras para almacenar las claves
  • Supervisar el uso de API para detectar cualquier actividad inusual Implemente controles de acceso adecuados en sus aplicaciones.

​
Dirección clave

  • Regeneración - Rote las claves API periódicamente o cuando los miembros del equipo se marchen
  • Monitoreo - Rastrear los patrones de uso de API y configurar alertas para actividad inusual
  • Control de acceso - Limitar el acceso a la clave API únicamente a los miembros del equipo que lo necesiten.
  • Almacenamiento de respaldo - Guarde las llaves en múltiples ubicaciones seguras con controles de acceso adecuados.

​
Casos de uso comunes

​
Automatización de campañas

Automatice la creación de campañas, los ajustes de presupuesto y la optimización del rendimiento en función de reglas y activadores predefinidos.

​
Integración de informes

Incorpore los datos de rendimiento de Toppie a las herramientas de inteligencia empresarial existentes o a los paneles personalizados para obtener informes unificados.

​
Gestión de inventarios

Sincroniza automáticamente los catálogos de productos y mantén actualizado el inventario en todos tus socios minoristas.

​
Optimización presupuestaria

Implementar algoritmos personalizados de asignación presupuestaria basados en métricas de rendimiento y objetivos empresariales.
Para obtener ayuda con la integración de API o para analizar casos de uso avanzados de gestión de campañas programáticas, póngase en contacto con su gestor de cuenta de Toppie.
Last updated: