> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Toppie

> Intégrez avec Toppie de manière programmatique en utilisant notre API

export const IntegrationsCard1AFr = () => {
  return <>
      <style>{`
        .integrations-card-1a-fr {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a-fr:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-fr {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a-fr:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-fr-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: wrap;
        }

        .integrations-card-1a-fr-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-fr-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-fr h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a-fr h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-fr-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-fr-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a-fr p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a-fr p {
          color: #d1d5db;
        }

        .integrations-card-1a-fr a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a-fr a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a-fr a {
          color: #8280ff;
        }

        .dark .integrations-card-1a-fr a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-fr-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-fr-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a-fr p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a-fr h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-fr-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-fr">
        <div className="integrations-card-1a-fr-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/gui.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/linn.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/max.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="" loading="lazy" className="integrations-card-1a-fr-avatar" />
        </div>

        <h2>Besoin d'aide avec votre intégration Topsort ?</h2>

        <p className="integrations-card-1a-fr-subtitle">
          Parlez-nous, l'équipe d'ingénierie des intégrations.
        </p>

        <p>
          Contactez-nous via <strong>votre canal de messagerie dédié</strong> ou à{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Si vous n'êtes pas encore client,{" "}
          <a href="https://www.topsort.com/book-a-demo">planifiez une démo</a> avec notre
          équipe de vente.
        </p>
      </div>
    </>;
};

<Note>
  L'API Toppie permet un accès programmatique sécurisé à la plateforme unifiée de retail media de Topsort. Que vous automatisiez la gestion de campagnes, créiez des tableaux de bord personnalisés ou intégriez des données Toppie dans des flux de travail existants, l'API fournit la base pour faire évoluer les opérations de retail media au-delà de l'interface utilisateur.
</Note>

L'API Toppie fournit des endpoints publics pour gérer et analyser les comptes d'agence, les campagnes et l'activité financière sur plusieurs partenaires de distribution.

<Card title="Référence de l'API Toppie" icon="book" href="/fr/api-reference/toppie-api/">
  Consultez la documentation complète de l'API avec tous les endpoints disponibles
</Card>

## Avantages Clés

* **Automatiser les Opérations de Campagne** - Créez des flux de travail pour gérer les campagnes sur les distributeurs sans intervention manuelle
* **Intégrations Personnalisées** - Connectez les données Toppie aux outils de BI et aux systèmes internes
* **Contrôle d'Accès Sécurisé** - Permissions basées sur les rôles pour les données et les capacités

## Capacités de l'API

L'API Toppie offre des fonctionnalités complètes via les endpoints suivants :

<AccordionGroup>
  <Accordion title="Gestion de Catalogue de Produits" icon="box">
    Téléchargez, mettez à jour et gérez les catalogues de produits chez les partenaires de distribution. Maintenez l'inventaire synchronisé et assurez des informations produit précises pour vos campagnes.
  </Accordion>

  <Accordion title="Opérations de Cycle de Vie de Campagne" icon="rectangle-ad">
    Créez, modifiez, mettez en pause et supprimez des campagnes de manière programmatique. Définissez les budgets, les paramètres de ciblage et les stratégies d'enchères pour les Listings Sponsorisés et les Bannières.
  </Accordion>

  <Accordion title="Analyse Avancée et Rapports" icon="chart-line">
    Récupérez les données de performance en temps réel incluant les impressions, les clics, les conversions, les métriques de ROAS et les dépenses publicitaires. Générez des rapports personnalisés avec des plages de dates et des sélections de métriques spécifiques.
  </Accordion>

  <Accordion title="Gestion du Budget et des Enchères" icon="dollar-sign">
    Suivez les soldes de compte, consultez l'historique des transactions et gérez la facturation de manière programmatique. Implémentez des algorithmes personnalisés d'allocation de budget basés sur les métriques de performance.
  </Accordion>
</AccordionGroup>

## Authentification

Toutes les requêtes de l'API Toppie nécessitent une authentification utilisant des clés API avec authentification basée sur des tokens. Cela garantit un accès sécurisé à vos campagnes et données.

### Obtenir votre Clé API

<Steps>
  <Step title="Naviguer vers Paramètres">
    Accédez aux **Paramètres** dans la navigation de votre tableau de bord Toppie
  </Step>

  <Step title="Sélectionner Intégration API">
    Choisissez **Intégration API** dans le menu de navigation de gauche
  </Step>

  <Step title="Créer une Nouvelle Clé">
    Cliquez sur le bouton **"+ Nouvelle Clé API"** pour générer une nouvelle clé
  </Step>

  <Step title="Sauvegarder Immédiatement">
    <Warning>
      Copiez et sauvegardez votre clé API immédiatement—elle ne sera affichée qu'une seule fois pour des raisons de sécurité
    </Warning>
  </Step>
</Steps>

### Utiliser votre Clé API

Incluez votre clé API dans l'en-tête `Authorization` de chaque requête :

```bash theme={null}
curl -X GET "https://api.topsort.com/toppie/v1/campaigns" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json"
```

### Meilleures Pratiques de Sécurité

<Warning>
  **Directives de Sécurité :**

  * Ne partagez jamais les clés API dans les dépôts de code ou les canaux publics
  * Effectuez une rotation régulière des clés pour une sécurité accrue
  * Utilisez des variables d'environnement ou des coffres-forts sécurisés pour stocker les clés
  * Surveillez l'utilisation de l'API pour détecter toute activité inhabituelle
  * Implémentez des contrôles d'accès appropriés dans vos applications
</Warning>

## Cas d'Usage Courants

<Tabs>
  <Tab title="Automatisation de Campagnes">
    Automatisez la création de campagnes, les ajustements de budget et l'optimisation des performances basés sur des règles et des déclencheurs prédéfinis. Créez des flux de travail qui répondent aux seuils de performance ou aux conditions du marché.

    **Scénarios d'exemple :**

    * Mettre automatiquement en pause les campagnes lorsque le ROAS tombe en dessous de la cible
    * Créer de nouvelles campagnes basées sur les mises à jour du catalogue de produits
    * Ajuster dynamiquement les enchères en fonction de l'heure de la journée ou des niveaux d'inventaire
  </Tab>

  <Tab title="Intégration de Rapports">
    Extrayez les données de performance de Toppie vers des outils de business intelligence existants ou des tableaux de bord personnalisés pour des rapports unifiés sur tous les canaux marketing.

    **Scénarios d'exemple :**

    * Synchroniser les métriques de campagne quotidiennes vers Google Sheets ou Excel
    * Alimenter les données dans les tableaux de bord Tableau, Looker ou Power BI
    * Agréger les performances de retail media avec d'autres canaux marketing
  </Tab>

  <Tab title="Gestion d'Inventaire">
    Synchronisez automatiquement les catalogues de produits et maintenez l'inventaire à jour chez tous les partenaires de distribution, garantissant que les campagnes promeuvent toujours les produits disponibles.

    **Scénarios d'exemple :**

    * Synchroniser la disponibilité des produits depuis votre système PIM
    * Mettre à jour les prix et promotions dans toutes les campagnes
    * Retirer les produits en rupture de stock des campagnes actives
  </Tab>

  <Tab title="Optimisation du Budget">
    Implémentez des algorithmes personnalisés d'allocation de budget basés sur les métriques de performance et les objectifs commerciaux pour maximiser les retours chez les partenaires de distribution.

    **Scénarios d'exemple :**

    * Réallouer les budgets vers les distributeurs les plus performants
    * Implémenter des algorithmes de rythme personnalisés
    * Coordonner les dépenses sur plusieurs campagnes et distributeurs
  </Tab>
</Tabs>

## Documentation de l'API

Pour la documentation complète de référence de l'API incluant les spécifications des endpoints, les paramètres, les exemples de requête/réponse et les directives de gestion des erreurs, visitez la [Référence de l'API Toppie](/fr/api-reference/toppie-api/).

<IntegrationsCard1AFr />