# Agences, équipes et API

Agences : faites la publicité de vos clients sur Agilis sous leur nom. Rôles d’équipe, soldes, factures et utilisation de l’API REST Agilis.

**En bref :** une agence s’inscrit une seule fois, sous sa propre raison sociale, et fait de la publicité pour ses clients en saisissant le nom de chaque client dans **Nom affiché aux membres**. L’agence paie, détient les soldes et reçoit les factures. Les développeurs peuvent créer et gérer des offres et des événements via l’**API REST Agilis** (https://ads.agilis.dating) avec des clés API créées dans l’Espace annonceurs ; les clés de test sont gratuites et rien n’est jamais montré aux membres.

## Pour les agences

1. **Inscrivez l’agence** sous sa propre raison sociale. → [Comment s’inscrire](https://www.agilis.dating/fr/business/guide/register)
2. Lorsque vous créez une offre ou un événement, saisissez le **nom de votre client** dans **Nom affiché aux membres**. Les membres voient le nom du client, pas le vôtre.
3. Vous devez être autorisé par chaque client à faire de la publicité pour son compte. Les Conditions générales de publicité en rendent l’agence responsable.

**Qui paie, et qui reçoit les factures**

- C’est le compte de votre agence qui paie, dans la devise de facturation de votre agence.
- Chaque personne de votre agence dispose de son propre solde et paie avec celui-ci. Le solde de l’organisation en est le total. → [Fonctionnement des soldes](https://www.agilis.dating/fr/business/guide/pricing)
- Les factures et les résultats sont au nom de votre agence, avec une facture par paiement, pour que vous puissiez refacturer chaque client.
- Pour séparer les dépenses de chaque client, utilisez une offre ou un événement par client et refacturez à partir de la facture correspondante.

## Rôles de l’équipe

Les administrateurs de l’organisation et les annonceurs travaillent dans l’Espace annonceurs ; les développeurs passent par l’API. Les développeurs ne peuvent pas créer d’offres ni d’événements dans l’Espace annonceurs, mais avec leurs clés API, ils peuvent en créer, en publier et les payer via l’API ; votre entreprise est responsable de l’utilisation de ses clés. Le tableau complet se trouve dans [Rôles et autorisations de l’équipe](https://www.agilis.dating/fr/business/guide/getting-started).

## L’API REST Agilis

- **URL de base :** https://ads.agilis.dating
- **Référence :** www.agilis.dating/api-doc, avec des exemples en cURL, Python, Node.js et PHP, et un assistant API
- **Format lisible par machine :** OpenAPI 3.1 sur www.agilis.dating/openapi.json, Markdown sur www.agilis.dating/api-doc.md, et le texte intégral pour les outils d’IA sur www.agilis.dating/llms-full.txt
- **Offres :** lister vos catégories et les centres d’intérêt ; estimer le prix d’une offre avant de la créer ; créer, lister, mettre en pause, reprendre et supprimer des offres ; consulter les résultats de chaque offre
- **Événements :** prévisualiser, publier, lister, modifier, reprogrammer, annuler et supprimer des événements ; consulter les résultats de chaque événement

### Obtenir une clé API

1. Connectez-vous à l’Espace annonceurs en tant qu’administrateur de l’organisation ou développeur.
2. Choisissez **Mode test** ou Mode réel avec le sélecteur en haut de la page.
3. Accédez à **Clés API** → **Créer une clé**, donnez-lui un nom et, si vous le souhaitez, une date d’expiration.
4. **Copiez la clé immédiatement.** Vous ne pourrez plus la voir ensuite.

Les clés de test commencent par `pk_test_` ; les clés réelles par `pk_live_`. Chaque personne peut avoir jusqu’à 10 clés dans chaque mode. **Renouveler** remplace une clé immédiatement : mettez donc d’abord vos systèmes à jour. Envoyez la clé dans l’en-tête de requête `x-api-key` : `x-api-key: pk_test_…`.

### Développer en toute sécurité

- Développez et testez avec une clé `pk_test_` : les offres et événements de test sont gratuits et ne sont jamais montrés aux membres.
- Estimez le prix d’une offre avec le point de terminaison d’estimation de prix avant de la créer.
- Ne placez pas vos clés dans des dépôts de code ni dans des navigateurs ; appelez l’API depuis votre serveur.

## Questions

### Une agence peut-elle gérer plusieurs clients depuis un seul compte ?

Oui. Inscrivez l’agence une seule fois et indiquez le nom du client sur chaque offre ou événement.

### Chaque client peut-il avoir sa propre facture ?

Les factures sont émises au nom de votre agence, une par paiement. Refacturez vos clients à partir de celles-ci.

### Existe-t-il un environnement de test ?

Oui. Le Mode test, avec des clés `pk_test_`, est un environnement de test complet. Rien n’est facturé et rien n’est montré aux membres.

### Puis-je connecter des assistants de programmation par IA ?

Oui. Indiquez à votre outil www.agilis.dating/api-doc.md ou www.agilis.dating/openapi.json.

Source: https://www.agilis.dating/fr/business/guide/agencies-and-api