Intégrations

Le hub Integrations de l'Admin Panel est l'endroit ou les administrateurs connectent PetroBench aux systemes de donnees de l'entreprise et ouvrent l'API Console pour l'organisation.

Ouvrir Integrations

1. Basculez vers Admin Panel
2. Ouvrez API & Integrations > Overview (le libelle peut afficher Integrations)
3. Examinez les connecteurs mis en avant et les listes par categorie (Oil & Gas, Cloud & Data, Identity & Access, et groupes associes)

Le hub affiche les totaux de integrations disponibles et connectees lorsque votre org y a acces.

Ce que vous gerez ici

Les cles API personnelles restent sous Settings. Le hub Admin Panel est la surface developpeur au niveau de l'organisation.

EventHub et synchronisation warehouse

Pour EventHub, Snowflake et les workflows de synchronisation associes, utilisez les guides Enterprise :

• Integrations overview
• Getting started with the API

Depuis l'Admin Panel, vous effectuez generalement :

1. Ouvrir la carte de l'integration connectee
2. Examiner les mappings de champs, le planning de synchronisation et les logs recents
3. Resoudre les revues de correspondance d'equipement lorsque le connecteur met en file des correspondances a faible confiance

Console API

L'API Console est l'espace in-app pour l'acces API de l'organisation. Ouvrez Admin Panel > API & Integrations > API Console.

Elle comprend quatre onglets :

Usage

Usage affiche le volume de requetes API, les quotas et la consommation de tokens pour la periode en cours.

Les cartes typiques incluent :

• Compteurs de requetes organisation et personnelles, temps de reponse moyen et taux d'erreur
• Plan limits : requetes par minute, aggregate division, executions concurrentes, plafond quotidien de tokens
• Monthly quotas : lectures, ecritures, executions de simulation et livraisons webhook
• Daily activity plus principaux endpoints et consommateurs lorsque le trafic existe

Utilisez cet onglet pour diagnostiquer les rate limits, la pression sur les quotas ou les erreurs API inattendues. Voir aussi Rate limits.

Service Tokens

Les Service Tokens sont des identifiants longue duree appartenant a la division, pas a une personne. Ils continuent de fonctionner apres le depart du createur.

Creer un service token

1. Allez dans Admin Panel > API & Integrations > API Console
2. Ouvrez l'onglet Service Tokens
3. Cliquez sur Create service token
4. Saisissez un Token name (par exemple Nightly Snowflake Sync)
5. Choisissez une Expiration (30 jours, 90 jours ou 1 an)
6. Definissez optionnellement une IP allowlist
7. Selectionnez les Permissions (scopes) pour Wells, Simulations, Equipment et Organization
8. Cliquez sur Create service token
9. Copiez le token en clair immediatement : il n'est affiche qu'une seule fois

Depuis le menu de ligne, vous pouvez renommer, faire pivoter ou revoquer un token. Chaque division a un nombre limite de tokens actifs (affiche en utilise sur total dans la liste).

Details complets d'authentification : API authentication.

Webhooks

Les Webhooks enregistrent des endpoints HTTP que PetroBench appelle lors d'evenements (par exemple well.created ou simulation.failed).

1. Ouvrez l'onglet Webhooks
2. Cliquez sur Add Webhook
3. Saisissez l'URL de l'endpoint et selectionnez les evenements
4. Enregistrez, puis utilisez le controle send/test pour verifier la livraison

Connect

L'onglet Connect vous aide a pointer la CLI, les clients MCP (Claude, ChatGPT, Cursor), cURL ou Python vers votre workspace. Copiez la configuration pour votre client, puis remplacez le placeholder de cle API par un service token ou une cle personnelle.

Pour la configuration client pas a pas, voir Getting started et la reference MCP.

Qui peut acceder

Voir aussi

• Apps pour les applications installees et l'activation Marketplace
• Getting started with the API
• API authentication
• Rate limits
• RBAC pour qui peut gerer les parametres de l'organisation