Integraties
Open de hub voor integraties in het beheerdersdashboard om EventHub, datawarehouse-connectors en de API-console te verbinden. Beschikbaarheid is afhankelijk van plan en uitrol.
De Integrations hub in het beheerdersdashboard is waar beheerders PetroBench verbinden met bedrijfsgegevenssystemen en de API Console openen voor de organisatie.
Dit beheerdersdashboard wordt binnenkort uitgerold en verschijnt mogelijk nog niet in elke organisatie. Als het voor uw abonnement is ingeschakeld, vindt u het onder Admin Panel > API & Integrations. Uitgebreide installatiehandleidingen zijn beschikbaar in Enterprise Integrations.
Open integraties
- Schakel over naar Admin Panel
- Open API & Integrations > Overview (label kan worden weergegeven als Integrations)
- Bekijk aanbevolen connectoren en categorielijsten (Olie & Gas, Cloud & Data, Identiteit & Toegang en gerelateerde groepen)
De hub toont totalen voor beschikbare en verbonden integraties wanneer uw organisatie toegang heeft.
Wat je hier beheert
| Gebied | Doel |
|---|---|
| Connector catalog | Bekijk de integraties die beschikbaar zijn voor uw organisatie |
| Connection status | Bekijk welke connectoren zijn ingeschakeld of binnenkort beschikbaar zijn |
| EventHub | Open synchronisatieconfiguratie en logboeken voor een actieve magazijnverbinding |
| API Console | Servicetokens, webhooks, gebruik en configuraties voor clientverbindingen |
Persoonlijke API-sleutels staan nog steeds onder [Instellingen] (/docs/nl/settings/profile). De hub voor het beheerdersdashboard is het ontwikkelaarsoppervlak op organisatieniveau.
EventHub en magazijnsynchronisatie
Voor EventHub, Snowflake en gerelateerde synchronisatieworkflows gebruikt u de Enterprise-handleidingen:
Vanuit het beheerdersdashboard doet u doorgaans het volgende:
- Open de aangesloten integratiekaart
- Bekijk de veldtoewijzingen, het synchronisatieschema en recente synchronisatielogboeken
- Los beoordelingen van apparatuurwedstrijden op wanneer de connector wedstrijden met weinig vertrouwen in de wachtrij plaatst
Apparatuurmatches met een lager vertrouwen uit inkomende synchronisatie worden in de wachtrij geplaatst voor beoordeling door de beheerder, zodat technici niet stilletjes de verkeerde pompeenheid of staafkwaliteit krijgen.
API-console
API Console is de in-app-thuisbasis voor API-toegang voor organisaties. Open Admin Panel > API & Integrations > API Console.
Het bevat vier tabbladen:
| Tabblad | Doel |
|---|---|
| Service Tokens | Munt en beheer tokens die eigendom zijn van de divisie voor servers en banen |
| Webhooks | Registreer HTTP-eindpunten voor platformgebeurtenissen |
| Usage | Volume van live-aanvragen, abonnementslimieten en maandelijkse quota |
| Connect | Kopieerklare configuratie voor CLI, MCP-clients en REST |
Gebruik
Usage toont het volume van API-aanvragen, quota's en tokenverbruik voor de huidige periode.
Typische kaarten zijn onder meer:
- Aantal organisatorische en persoonlijke verzoeken, gemiddelde responstijd en foutenpercentage
- Plan limits - verzoeken per minuut, totaal van divisies, gelijktijdige runs, dagelijks tokenplafond
- Monthly quotas - lezen, schrijven, simulatieruns en webhookleveringen
- Daily activity plus topeindpunten en consumenten als er verkeer is
Gebruik dit tabblad bij het diagnosticeren van tarieflimieten, quotadruk of onverwachte API-fouten. Zie ook Tarieflimieten.
Servicetokens
Service Tokens zijn langlevende inloggegevens die eigendom zijn van de division, niet van een persoon. Ze blijven werken nadat de maker is vertrokken.
Maak een servicetoken
- Ga naar Admin Panel > API & Integrations > API Console
- Open het tabblad Service Tokens
- Klik op Create service token
- Voer een Token name in (bijvoorbeeld
Nightly Snowflake Sync) - Kies een Expiration (30 dagen, 90 dagen of 1 jaar)
- Stel eventueel een IP allowlist in
- Selecteer Permissions (scopes) voor bronnen, simulaties, apparatuur en organisatie
- Klik op Create service token
- Kopieer het leesbare teksttoken onmiddellijk - het wordt slechts één keer weergegeven
Vanuit het rijmenu kunt u een token hernoemen, roteren of intrekken. Elke divisie heeft een beperkt aantal actieve tokens (weergegeven als gebruikt van het totaal op de lijst).
Geef de voorkeur aan servicetokens voor geplande taken en integraties. Geef de voorkeur aan persoonlijke API-sleutels alleen wanneer één enkele technicus de API interactief aanroept.
Volledige authentificatiedetails: API-authenticatie.
Webhooks
Webhooks registreert HTTP-eindpunten die PetroBench aanroept wanneer er gebeurtenissen plaatsvinden (bijvoorbeeld well.created of simulation.failed).
- Open het tabblad Webhooks
- Klik op Add Webhook
- Voer de eindpunt-URL in en selecteer gebeurtenissen
- Sla op en gebruik vervolgens de verzend-/testcontrole om de bezorging te verifiëren
Verbinden
Met het tabblad Connect kunt u de CLI, MCP-clients (Claude, ChatGPT, Cursor), cURL of Python naar uw werkruimte verwijzen. Kopieer de configuratie voor uw client en vervang vervolgens de tijdelijke aanduiding voor de API-sleutel door een servicetoken of persoonlijke sleutel.
Voor stapsgewijze clientconfiguratie, zie Aan de slag en de MCP-referentie.
Wie heeft toegang
| Actie | Hoofdkantoorbeheerder | Divisiebeheerder | Regiobeheerder |
|---|---|---|---|
| Bekijk Integratieshub | Ja | Varieert per abonnement | Nee |
| Configureer EventHub | Ja | Varieert per abonnement | Nee |
| Open API-console (gebruik, verbinding maken) | Ja | Ja (eigen divisie) | Nee |
| Servicetokens beheren | Ja | Ja (eigen divisie) | Nee |
| Webhooks beheren | Ja | Ja (eigen divisie) | Nee |
Verwant
- Apps voor geïnstalleerde applicaties en marktplaatsinschakeling
- Aan de slag met de API
- API-authenticatie
- Tarieflimieten
- RBAC voor wie organisatie-instellingen kan beheren