Conector propio
El catálogo de Weldra no cubre todos los sistemas del mundo. Si el tuyo no está, hay dos caminos, según lo que necesites.
Camino 1: el conector HTTP genérico
Para una API REST que no tiene conector. Declaras en la conexión la dirección base, cómo se autentica y los endpoints que quieres leer o escribir, y Weldra los trata como cualquier otro sistema. Admite autenticación por cabecera con token, básica, por clave de API en una cabecera, o sin autenticación, y una sesión de login. Las credenciales son campos secretos de la conexión.
Toda llamada sale por una guarda de salida: por defecto solo se habla con el servidor de la dirección base, salvo que listes otros dominios permitidos. Es el camino rápido para mandar un alta, una actualización o un aviso a una API concreta. Para un sistema que vas a usar en muchas integraciones, es mejor el camino 2.
Camino 2: un conector declarativo
Un conector declarativo es un fichero YAML, el manifest.yaml: describe la API de un sistema (dónde está, cómo se autentica, cómo pagina, qué recursos tiene y cómo se leen y se escriben) y el motor del SDK de Weldra hace el resto. No hace falta escribir Python. Si tu sistema no cabe en el formato, el formato se amplía; no se obliga a escribir código aparte.
Este es un manifiesto de ejemplo para un ERP inventado, con un recurso de productos. Lo hemos validado con hub-sdk validate, la herramienta del SDK:
name: mi_erp
version: 0.1.0
requires_sdk: ">=0.33,<1"
kind: declarative
label: Mi ERP
config_schema:
properties:
base_url: { type: string, format: uri, title: URL base }
token: { type: string, secret: true, title: Token API }
required: [base_url, token]
capabilities: { read: true, write: true, incremental: true, webhooks: false }
resources: [products]
spec:
base_url: https://erp.example.com
auth: { type: bearer, token_field: token }
pagination: { type: offset, page_size: 200, limit_param: limit, offset_param: offset }
rate_limit_rps: 5
check_path: /api/ping
resources:
products:
read:
path: /api/products
items_path: data
id_field: sku
revision_field: updated_at
cursor_field: updated_at
cursor_param: modified_after
write:
wrap: product
create: { method: POST, path: /api/products, id_path: product.sku, revision_path: product.updated_at }
update: { method: PUT, path: "/api/products/{id}", revision_path: product.updated_at }
Qué dice cada parte:
config_schemaes lo que se pide al crear una conexión. Todo campo que lleve una credencial se marcasecret: true: así se guarda cifrado y no se devuelve nunca.capabilitiesdeclara lo que el conector sabe hacer. Solo se declara lo que de verdad funciona.speces la API: la dirección base, la autenticación (token_fielddice de qué campo de la conexión sale el token), la paginación y la frecuencia máxima de llamadas.- En cada recurso,
readdice la ruta, dónde está la lista (items_path), cuál es el id (id_field) y por qué campo se lee solo lo cambiado (cursor_field).writedice cómo se crea y se actualiza.
Cómo llega al catálogo
Hoy un conector declarativo no se sube desde la app: se instala en el hub por nuestro equipo. Las guías técnicas están en el repositorio del SDK y en el de conectores. Si quieres que cubramos tu sistema, o escribirlo tú, escribe a hello@weldra.ai.
Qué camino elegir
| Si… | Elige |
|---|---|
| Solo necesitas mandar o leer de un par de endpoints de una API tuya | Conector HTTP genérico |
| Quieres un sistema completo, reutilizable en varias integraciones | Conector declarativo |
| Tu API no cabe en el formato declarativo | Escríbenos: se amplía el formato o se hace un conector en Python |
Después de conectarlo, el resto es igual que con cualquier otro sistema: lo cuenta Cómo funciona. Para saber cuánto cuesta, Precios.