Saltar al contenido principal
POST
/
v1
/
discovery
/
connections
/
{connectionId}
/
extractions
Iniciar una extracción de conexión
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tables": {},
  "startDate": "<string>",
  "endDate": "<string>",
  "filters": {
    "equals": {}
  }
}
'
{
  "id": "<string>",
  "connectionId": "<string>",
  "status": "<string>",
  "ingestionJobId": "<string>",
  "startDate": "<string>",
  "endDate": "<string>",
  "tables": {},
  "filters": {
    "equals": {}
  },
  "errorMessage": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "bridgeAttempts": 0,
  "bridgeLastError": "",
  "bridgeLastErrorMessage": "",
  "bridgeFailedAt": "2023-11-07T05:31:56Z",
  "custodyDeletedAt": "2023-11-07T05:31:56Z"
}

Autorizaciones

​
Authorization
string
header
requerido

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

Encabezados

​
X-Request-Id
string

Un identificador único para rastrear la solicitud entre servicios.

Parámetros de ruta

​
connectionId
string
requerido

El identificador único de la conexión.

Cuerpo

application/json

Carga útil de la solicitud de extracción

Payload de solicitud para iniciar una extracción de datos desde una conexión descubierta

​
tables
object
requerido

Tablas de las que se extraerán datos, indexadas por nombre de tabla

​
startDate
string

Inicio del rango de fechas a extraer (RFC 3339)

​
endDate
string

Fin del rango de fechas a extraer (RFC 3339)

​
filters
object

Filtros opcionales a nivel de fila para una extracción

Respuesta

Solicitud de extracción creada

Una solicitud de extracción enviada a Fetcher

​
id
string

Identificador interno de la solicitud de extracción

​
connectionId
string

Conexión a la que se envió esta extracción

​
status
string

Estado actual del ciclo de vida de la extracción

​
ingestionJobId
string

Identificador de trabajo devuelto por Fetcher

​
startDate
string

Inicio del rango de fechas extraído

​
endDate
string

Fin del rango de fechas extraído

​
tables
object

Estado de extracción por tabla

​
filters
object

Filtros opcionales a nivel de fila para una extracción

​
errorMessage
string

Detalles del error si la extracción falló

​
createdAt
string

Marca de tiempo en que se solicitó la extracción

​
updatedAt
string

Marca de tiempo de la última actualización de estado

​
bridgeAttempts
integer

Número de veces que el pipeline puente de Matcher ha intentado recuperar e ingestar esta extracción

Ejemplo:

0

​
bridgeLastError
string

Clase de error del último fallo del pipeline puente

Ejemplo:

""

​
bridgeLastErrorMessage
string

Mensaje de error con historial acumulado del pipeline puente; el fallo principal permanece al principio

Ejemplo:

""

​
bridgeFailedAt
string<date-time> | null

Marca de tiempo del primer fallo terminal del pipeline puente; se omite cuando no ha ocurrido ningún fallo

​
custodyDeletedAt
string<date-time> | null

Marca de tiempo en que se eliminó el objeto en custodia; se omite cuando aún está en posesión