Integrationen
Öffnen Sie den Admin Panel Integrations-Hub, um EventHub, Data Warehouse-Konnektoren und die API-Konsole zu verbinden. Die Verfügbarkeit hängt vom Plan und der Einführung ab.
Über den Integrations-Hub im Admin Panel verbinden Administratoren PetroBench mit Unternehmensdatensystemen und öffnen den API Console für die Organisation.
Diese Admin Panel-Oberfläche wird gerade eingeführt und ist möglicherweise noch nicht in jeder Organisation verfügbar. Wenn es für Ihren Plan aktiviert ist, finden Sie es unter Admin Panel > API & Integrations. Ausführliche Einrichtungsanleitungen finden Sie in Enterprise Integrations.
Offene Integrationen
- Wechseln Sie zu Admin Panel
- Öffnen Sie API & Integrations > Overview (die Bezeichnung wird möglicherweise als Integrations angezeigt)
- Überprüfen Sie die vorgestellten Konnektoren und Kategorielisten (Öl und Gas, Cloud und Daten, Identität und Zugriff sowie verwandte Gruppen).
Der Hub zeigt Gesamtzahlen für verfügbare und verbundene Integrationen an, wenn Ihre Organisation Zugriff hat.
Was du hier schaffst
| Bereich | Zweck |
|---|---|
| Connector catalog | Durchsuchen Sie die für Ihre Organisation verfügbaren Integrationen |
| Connection status | Sehen Sie, welche Konnektoren aktiviert sind oder bald verfügbar sind |
| EventHub | Synchronisierungskonfiguration und Protokolle für eine aktive Warehouse-Verbindung öffnen |
| API Console | Service-Tokens, Webhooks, Nutzung und Client-Verbindungskonfigurationen |
Persönliche API-Schlüssel sind weiterhin unter Einstellungen verfügbar. Der Admin Panel-Hub ist die Entwickleroberfläche auf Organisationsebene.
EventHub- und Warehouse-Synchronisierung
Verwenden Sie für EventHub, Snowflake und zugehörige Synchronisierungsworkflows die Enterprise-Anleitungen:
Vom Admin Panel aus können Sie normalerweise Folgendes tun:
- Öffnen Sie die angeschlossene Integrationskarte
- Überprüfen Sie die Feldzuordnungen, den Synchronisierungsplan und die aktuellen Synchronisierungsprotokolle
- Lösen Sie Überprüfungen von Geräteübereinstimmungen auf, wenn der Konnektor Übereinstimmungen mit geringer Konfidenz in die Warteschlange stellt
Übereinstimmungen mit Geräten mit geringerer Zuverlässigkeit aus der eingehenden Synchronisierung werden zur Überprüfung durch den Administrator in die Warteschlange gestellt, damit Ingenieure nicht stillschweigend die falsche Pumpeinheit oder Stangensorte erhalten.
API-Konsole
API Console ist die In-App-Startseite für den API-Zugriff der Organisation. Öffnen Sie Admin Panel > API & Integrations > API Console.
Es enthält vier Registerkarten:
| Tab | Zweck |
|---|---|
| Service Tokens | Prägen und verwalten Sie abteilungseigene Token für Server und Jobs |
| Webhooks | Registrieren Sie HTTP-Endpunkte für Plattformereignisse |
| Usage | Live-Anfragevolumen, Planlimits und monatliche Kontingente |
| Connect | Kopierbereite Konfiguration für CLI, MCP-Clients und REST |
Verwendung
Usage zeigt API-Anfragevolumen, Kontingente und Token-Verbrauch für den aktuellen Zeitraum.
Typische Karten sind:
- Anzahl der organisatorischen und persönlichen Anfragen, durchschnittliche Antwortzeit und Fehlerquote
- Plan limits – Anfragen pro Minute, Teilungsaggregat, gleichzeitige Läufe, tägliche Token-Obergrenze
- Monthly quotas – liest, schreibt, Simulationsläufe und Webhook-Lieferungen
- Daily activity plus Top-Endpunkte und Verbraucher, wenn Datenverkehr vorhanden ist
Verwenden Sie diese Registerkarte, wenn Sie Ratenbeschränkungen, Kontingentdruck oder unerwartete API-Fehler diagnostizieren. Siehe auch Ratenbegrenzungen.
Service-Token
Bei Service Tokens handelt es sich um langlebige Anmeldeinformationen, die dem division gehören, nicht einer Person. Sie arbeiten weiter, nachdem der Schöpfer gegangen ist.
Erstellen Sie ein Service-Token
- Gehen Sie zu Admin Panel > API & Integrations > API Console
- Öffnen Sie die Registerkarte Service Tokens
- Klicken Sie auf Create service token
- Geben Sie ein Token name ein (zum Beispiel
Nightly Snowflake Sync) - Wählen Sie ein Expiration (30 Tage, 90 Tage oder 1 Jahr)
- Optional einen IP allowlist einstellen
- Wählen Sie Permissions (Bereiche) für Brunnen, Simulationen, Ausrüstung und Organisation
- Klicken Sie auf Create service token
- Kopieren Sie das Klartext-Token sofort – es wird nur einmal angezeigt
Über das Zeilenmenü können Sie einen Token umbenennen, drehen oder widerrufen. Jede Division verfügt über eine begrenzte Anzahl aktiver Token (in der Liste wird die Anzahl der insgesamt verwendeten Token angezeigt).
Bevorzugen Sie Service-Tokens für geplante Jobs und Integrationen. Bevorzugen Sie [persönliche API-Schlüssel] (/docs/de/settings/profile) nur, wenn ein einzelner Ingenieur die API interaktiv aufruft.
Vollständige Authentifizierungsdetails: API-Authentifizierung.
Webhooks
Webhooks registriert HTTP-Endpunkte, die PetroBench aufruft, wenn Ereignisse auftreten (z. B. well.created oder simulation.failed).
- Öffnen Sie die Registerkarte Webhooks
- Klicken Sie auf Add Webhook
- Geben Sie die Endpunkt-URL ein und wählen Sie Ereignisse aus
- Speichern Sie und verwenden Sie dann die Sende-/Teststeuerung, um die Zustellung zu überprüfen
Verbinden
Mithilfe der Registerkarte „P61“ können Sie die CLI, MCP-Clients (Claude, ChatGPT, Cursor), cURL oder Python auf Ihren Arbeitsbereich verweisen. Kopieren Sie die Konfiguration für Ihren Client und ersetzen Sie dann den API-Schlüsselplatzhalter durch ein Service-Token oder einen persönlichen Schlüssel.
Eine schrittweise Client-Einrichtung finden Sie unter [Erste Schritte] (/enterprise/api/getting-started) und in der [MCP-Referenz] (/enterprise/api/mcp).
Wer hat Zugriff?
| Aktion | HQ-Administrator | Abteilungsadministrator | Regionsadministrator |
|---|---|---|---|
| Integrations-Hub anzeigen | Ja | Variiert je nach Plan | Nein |
| Konfigurieren Sie EventHub | Ja | Variiert je nach Plan | Nein |
| API-Konsole öffnen (Nutzung, Verbindung) | Ja | Ja (eigene Abteilung) | Nein |
| Service-Tokens verwalten | Ja | Ja (eigene Abteilung) | Nein |
| Webhooks verwalten | Ja | Ja (eigene Abteilung) | Nein |
Verwandt
- Apps für installierte Anwendungen und Marktplatzaktivierung
- Erste Schritte mit der API
- API-Authentifizierung
- Tarifgrenzen – RBAC für die Person, die Organisationseinstellungen verwalten kann