Saltar al contenido principal
POST
/
v1
/
contexts
/
{contextId}
/
sources
/
{sourceId}
/
bindings
Crear un source binding
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/contexts/{contextId}/sources/{sourceId}/bindings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "format": "<string>",
  "scheduleSpec": "<string>",
  "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "enabled": true
}
'
{
  "contextId": "<string>",
  "createdAt": "<string>",
  "enabled": true,
  "format": "<string>",
  "id": "<string>",
  "scheduleSpec": "<string>",
  "sourceId": "<string>",
  "updatedAt": "<string>",
  "connectionId": "<string>",
  "transportConfig": {
    "host": "<string>",
    "connectOptions": {},
    "credentialRef": "<string>",
    "glob": "<string>",
    "path": "<string>",
    "port": 123
  }
}

Autorizaciones

​
Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Parámetros de ruta

​
contextId
string<uuid>
requerido

Context ID ID del contexto

​
sourceId
string<uuid>
requerido

Source ID ID de la fuente

Cuerpo

application/json
​
format
string
requerido

Formato declarado que produce el binding, como una clave de descriptor con espacio de nombres de región/familia.

Required string length: 1 - 255
Ejemplo:

"br/cnab400/default"

​
kind
enum<string>
requerido

Carril por el que se extrae la fuente. file obtiene archivos vía un transporte; query extrae filas a través de una conexión del motor de descubrimiento. Exactamente un payload de carril es significativo por kind.

Opciones disponibles:
file,
query
Ejemplo:

"file"

​
scheduleSpec
string
requerido

Especificación de programación de intervalo que lee el programador del binding (cron o duración @every).

Required string length: 1 - 100
Ejemplo:

"@every 1h"

​
connectionId
string<uuid>

Referencia de conexión del motor de query (UUID). Requerida para el carril de query, rechazada para el carril de archivo.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
enabled
boolean

Si el binding se ejecuta de inmediato. Por defecto es true cuando se omite.

Ejemplo:

true

​
transportConfig
object

Configuración de transporte de archivo. Requerida para el carril de archivo, rechazada para el carril de query.

Respuesta

Creado

​
contextId
string
requerido

Identificador del contexto al que pertenece este binding.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
createdAt
string
requerido

Marca de tiempo de creación en formato RFC 3339.

Ejemplo:

"2025-01-15T10:30:00Z"

​
enabled
boolean
requerido

Si el binding se ejecuta.

Ejemplo:

true

​
format
string
requerido

Formato declarado que produce el binding, como una clave de descriptor con espacio de nombres de región/familia.

Ejemplo:

"br/cnab400/default"

​
id
string
requerido

Identificador único del binding.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
kind
enum<string>
requerido

Carril por el que se extrae la fuente. file obtiene archivos vía un transporte; query extrae filas a través de una conexión del motor de descubrimiento.

Opciones disponibles:
file,
query
Ejemplo:

"file"

​
scheduleSpec
string
requerido

Especificación de programación de intervalo que lee el programador del binding (cron o duración @every).

Ejemplo:

"@every 1h"

​
sourceId
string
requerido

Identificador de la fuente a la que pertenece este binding.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
updatedAt
string
requerido

Marca de tiempo de la última actualización en formato RFC 3339.

Ejemplo:

"2025-01-15T10:30:00Z"

​
connectionId
string

Referencia de conexión del motor de query (UUID). Se omite para bindings de archivo.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

​
transportConfig
object

Configuración de transporte de archivo. Se omite para bindings de query.