Outils de développement
CHAMPREP Les outils de développement offrent un moyen cohérent d’automatiser les workflows pris en charge sans faire appel aux backends des services individuels. L’authentification, l’accès aux services, les périmètres, les contrôles d’utilisation et le contexte d’audit sont appliqués au niveau de laAPI passerelle.
Choisissez un chemin d’intégration
Section intitulée « Choisissez un chemin d’intégration »| Parcours | Idéal pour | Commencez ici |
|---|---|---|
| API Gateway | Intégrations HTTPS directes et applications personnalisées | API Gateway Présentation |
| CHAMPREP CLI | Utilisation interactive du terminal, scripts et tâches d’infrastructure en continu (CI) | CLI Présentation |
| Webhooks | Intégrations pilotées par les événements qui ne doivent pas effectuer d’interrogations régulières | Webhooks |
| Officiel SDKs | Clients typés pour les services et frameworks pris en charge | CHAMPREP SDKs |
| SCIM 2.0 | Provisionnement via un fournisseur d’identité d’entreprise | SCIM Provisionnement |
Toutes les commandesCLI réseau et les requêtesSDK officielles utilisent la passerelle. Évitez de développer des intégrations en vous appuyant sur les URL d’un service accessibles via un navigateur ou réservées au backend ; ces routes ne constituent pas un contrat public stable.
Démarrage rapide
Section intitulée « Démarrage rapide »- Connectez-vous à CHAMPREPet ouvrez API Clés.
- Créez une clé ne comportant que les périmètres requis par votre intégration.
- Enregistrez la clé dans un gestionnaire de secrets ou dans le trousseau de clés du système d’exploitation.
- Envoyez une requête à la passerelle de production :
export CHAMPREP_TOKEN='replace-with-your-api-key'
curl --fail-with-body \ --header "Authorization: Bearer $CHAMPREP_TOKEN" \ https://api.champrep.com/v1/auth/whoamiLa réponse identifie le compte actif et le contexte d’identification. Poursuivez avec Authentification et clésAPI avant d’ajouter les périmètres de service.
Les contrôles de la plateforme s’appliquent toujours
Section intitulée « Les contrôles de la plateforme s’appliquent toujours »Une clé valide ne contourne pas les contrôles du produit qui s’appliquent dans CHAMPREP. Une requête ne peut aboutir que si toutes les conditions suivantes sont remplies :
- API Gateway L’accès est activé pour le forfait et le profil actifs.
- Le service de destination est disponible pour le forfait et l’organisation actifs.
- La clé contient le périmètre requis par la méthode et la ressource.
- Les contrôles d’utilisation en temps réel (à la minute, quotidiens et spécifiques à chaque service) le permettent.
- Le rôle actif est autorisé à effectuer l’opération dans le service de destination.
C’est pourquoi une cléAPI doit être considérée comme une interface supplémentaire pour le même compte, et non comme un moyen de contourner les politiques relatives au compte, au forfait, au rôle ou à l’organisation.