Saltar al contenido
Empezar gratis

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_schema es lo que se pide al crear una conexión. Todo campo que lleve una credencial se marca secret: true: así se guarda cifrado y no se devuelve nunca.
  • capabilities declara lo que el conector sabe hacer. Solo se declara lo que de verdad funciona.
  • spec es la API: la dirección base, la autenticación (token_field dice de qué campo de la conexión sale el token), la paginación y la frecuencia máxima de llamadas.
  • En cada recurso, read dice 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). write dice cómo se crea y se actualiza.

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.