Integraciones
Abra el hub Integrations del Admin Panel para conectar EventHub, conectores de data warehouse y el API Console. La disponibilidad depende del plan y del despliegue.
El hub Integrations en el Admin Panel es donde los administradores conectan PetroBench a sistemas de datos corporativos y abren el API Console para la organizacion.
Esta superficie del Admin Panel se esta desplegando gradualmente y puede no aparecer en todas las organizaciones aun. Cuando este habilitada para su plan, la encontrara en Admin Panel > API & Integrations. Las guias detalladas de configuracion estan en Enterprise Integrations.
Abrir Integrations
- Cambie a Admin Panel
- Abra API & Integrations > Overview (la etiqueta puede mostrarse como Integrations)
- Revise conectores destacados y listas por categoria (Oil & Gas, Cloud & Data, Identity & Access y grupos relacionados)
El hub muestra totales de integraciones disponibles y conectadas cuando su org tiene acceso.
Que administra aqui
| Area | Proposito |
|---|---|
| Connector catalog | Explore integraciones disponibles para su organizacion |
| Connection status | Vea que conectores estan habilitados o proximamente |
| EventHub | Abra configuracion de sincronizacion y logs para una conexion activa de warehouse |
| API Console | Service Tokens, webhooks, uso y configuraciones de conexion para clientes |
Las claves API personales siguen en Settings. El hub del Admin Panel es la superficie de desarrollador a nivel de organizacion.
EventHub y sincronizacion de warehouse
Para EventHub, Snowflake y flujos de sincronizacion relacionados, use las guias Enterprise:
Desde el Admin Panel tipicamente:
- Abra la tarjeta de integracion conectada
- Revise mapeos de campos, programacion de sincronizacion y logs recientes
- Resuelva revisiones de coincidencia de equipo cuando el conector encola coincidencias de baja confianza
Las coincidencias de equipo de menor confianza desde sincronizacion entrante se encolan para revision de administradores para que los ingenieros no reciban silenciosamente la unidad de bombeo o grado de varilla incorrecto.
Consola API
API Console es el inicio en la app para acceso API de la organizacion. Abra Admin Panel > API & Integrations > API Console.
Incluye cuatro pestanas:
| Pestaña | Proposito |
|---|---|
| Service Tokens | Crear y administrar tokens propiedad de la division para servidores y jobs |
| Webhooks | Registrar endpoints HTTP para eventos de la plataforma |
| Usage | Volumen de solicitudes en vivo, limites del plan y cuotas mensuales |
| Connect | Configuracion lista para copiar para CLI, clientes MCP y REST |
Usage
Usage muestra volumen de solicitudes API, cuotas y consumo de tokens para el periodo actual.
Las tarjetas tipicas incluyen:
- Conteos de solicitudes de organizacion y personales, tiempo de respuesta promedio y tasa de error
- Plan limits: solicitudes por minuto, agregado de division, ejecuciones concurrentes, techo diario de tokens
- Monthly quotas: lecturas, escrituras, ejecuciones de simulacion y entregas de webhook
- Daily activity mas endpoints y consumidores principales cuando hay trafico
Use esta pestana al diagnosticar rate limits, presion de cuota o errores API inesperados. Vea tambien Rate limits.
Service Tokens
Service Tokens son credenciales de larga duracion propiedad de la division, no de una persona. Siguen funcionando despues de que el creador se vaya.
Crear un service token
- Vaya a Admin Panel > API & Integrations > API Console
- Abra la pestana Service Tokens
- Haga clic en Create service token
- Ingrese un Token name (por ejemplo,
Nightly Snowflake Sync) - Elija Expiration (30 dias, 90 dias o 1 ano)
- Opcionalmente configure una IP allowlist
- Seleccione Permissions (scopes) para Wells, Simulations, Equipment y Organization
- Haga clic en Create service token
- Copie el token en texto plano de inmediato: solo se muestra una vez
Desde el menu de fila puede renombrar, rotar o revocar un token. Cada division tiene un numero limitado de tokens activos (mostrado como usados del total en la lista).
Prefiera service tokens para jobs programados e integraciones. Prefiera personal API keys solo cuando un ingeniero llama la API de forma interactiva.
Detalles completos de autenticacion: API authentication.
Webhooks
Webhooks registran endpoints HTTP que PetroBench llama cuando ocurren eventos (por ejemplo, well.created o simulation.failed).
- Abra la pestana Webhooks
- Haga clic en Add Webhook
- Ingrese la URL del endpoint y seleccione eventos
- Guarde, luego use el control send/test para verificar la entrega
Connect
La pestana Connect le ayuda a apuntar CLI, clientes MCP (Claude, ChatGPT, Cursor), cURL o Python a su workspace. Copie la config para su cliente, luego reemplace el placeholder de API key con un service token o clave personal.
Para configuracion paso a paso del cliente, vea Getting started y la referencia MCP.
Quien puede acceder
| Accion | HQ Admin | Division Admin | Region Admin |
|---|---|---|---|
| Ver hub Integrations | Si | Varia segun plan | — |
| Configurar EventHub | Si | Varia segun plan | — |
| Abrir API Console (Usage, Connect) | Si | Si (division propia) | — |
| Administrar Service Tokens | Si | Si (division propia) | — |
| Administrar Webhooks | Si | Si (division propia) | — |
Relacionado
- Apps para aplicaciones instaladas y habilitacion del marketplace
- Getting started with the API
- API authentication
- Rate limits
- RBAC para quien puede administrar configuracion de la organizacion