Saltar para o conteúdo principal
As claves API permitem o acceso seguro e programático à plataforma unificada de medios varejistas de Toppie. Tanto si automatiza a gestión de campanhas, crea paneles personalizados ou integra dados de Toppie en flujos de trabajo existentes, as claves API fornecen a base para escalar as operaciones de medios varejistas mais allá da interfaz de usuário.
As claves Toppie e API fornecen autenticação segura basada en tokens para o acceso programático a todos os endpoints Toppie. Esto permite a automatização da gestión de campanhas, a integração de datos e os flujos de trabajo de informes personalizados.

​
Beneficios clave

Automatizar as operaciones de campanha

Crea flujos de trabajo que creen, gestionen e optimicen campanhas en múltiplos varejistas sin intervenção manual.

Integraciones personalizadas

Conecte os dados de Toppie a ferramentas de BI, paneles de informes ou sistemas internos para obter análisis unificados de medios varejistas.

Control de acceso seguro

Os permisos basados en roles garantizan que os miembros do equipo solo accedan a os datos e as funcionalidades que necesitan.

​
Creando claves API

1

Navegue a Configuração

Acceda a Ajustes na navegação do pano de control de Toppie.
2

Seleccionar API Integração

Seleccione API Integração no menú de navegação da izquierda.
3

Criar nova clave

Haz clic no botón ”+ Nova clave API” para gerar una nova clave.
4

Ahorra inmediatamente

Copie e guardo seu clave API inmediatamente; solo se mostrará una vez por motivos de seguridade.
5

Almacenamiento seguro

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

​
Usando as claves API

Incluya seu clave API en os encabezados de solicitud para a autenticação ao realizar llamadas a Toppie API.

​
Encabezado de autenticação

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 à funcionalidade completa a través de Toppie API:
  • Gestión de catálogos de produtos - Cargar, actualizar e gerenciar catálogos de produtos
  • Operaciones do ciclo de vida da campanha - Criar, modificar e supervisar campanhas
  • Análises e informes avanzados - Acceda a dados de desempenho detallados
  • Gestión de presupuestos e licitaciones - Asignação e optimização programática do presupuesto

​
Documentação de API

Para obter a documentação de referencia completa de api, visite a toppie api Reference. A documentação inclui:
  • Especificaciones e parámetros do punto final
  • Ejempos de solicitud/respuesta
  • Directrices para o manejo de errores
  • Informação que limita a velocidade
  • Ejempos de SDK en varios idiomas

​
Melhores Práticas de seguridade

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

​
Direcção clave

  • Regeração - Rote as claves API periódicamente ou quando os miembros do equipo se marchen
  • Monitoreo - Rastrear os patrones de uso de API e configurar alertas para actividade inusual
  • Control de acceso - Limitar o acceso à clave API únicamente a os miembros do equipo que lo necesiten.
  • Almacenamiento de respaldo - Guarde as llaves en múltiplos ubicaciones seguras com controles de acceso adecuados.

​
Casos de Uso comunes

​
Automatização de campanhas

Automatice a creação de campanhas, os ajustes de presupuesto e a optimização do desempenho en função de regas e activadores predefinidos.

​
Integração de informes

Incorpore os dados de desempenho de Toppie a as ferramentas de inteligencia empresariao existentes ou a os paneles personalizados para obter informé umificados.

​
Gestión de inventarios

Sincroniza automáticamente os catálogos de produtos e mantén actualizado o inventario en todos suas socios varejistas.

​
Optimização presupuestaria

Implementar algoritmos personalizados de asignação presupuestaria basados en métricas de desempenho e objetivos empresariales.
Para obter ajuda com a integração de API ou para analizar casos de uso avanzados de gestión de campanhas programáticas, póngase en contacto com seu gestor de cuenta de Toppie.
Last updated: