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": {}
  }
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions"

payload = {
    "tables": {},
    "startDate": "<string>",
    "endDate": "<string>",
    "filters": { "equals": {} }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({tables: {}, startDate: '<string>', endDate: '<string>', filters: {equals: {}}})
};

fetch('https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tables' => [
        
    ],
    'startDate' => '<string>',
    'endDate' => '<string>',
    'filters' => [
        'equals' => [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions"

	payload := strings.NewReader("{\n  \"tables\": {},\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"filters\": {\n    \"equals\": {}\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tables\": {},\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"filters\": {\n    \"equals\": {}\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tables\": {},\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"filters\": {\n    \"equals\": {}\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "connectionId": "<string>",
  "status": "<string>",
  "ingestionJobId": "<string>",
  "startDate": "<string>",
  "endDate": "<string>",
  "tables": {},
  "filters": {
    "equals": {}
  },
  "errorMessage": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

POST

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": {}
  }
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions"

payload = {
    "tables": {},
    "startDate": "<string>",
    "endDate": "<string>",
    "filters": { "equals": {} }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({tables: {}, startDate: '<string>', endDate: '<string>', filters: {equals: {}}})
};

fetch('https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tables' => [
        
    ],
    'startDate' => '<string>',
    'endDate' => '<string>',
    'filters' => [
        'equals' => [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions"

	payload := strings.NewReader("{\n  \"tables\": {},\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"filters\": {\n    \"equals\": {}\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tables\": {},\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"filters\": {\n    \"equals\": {}\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/extractions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tables\": {},\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"filters\": {\n    \"equals\": {}\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "connectionId": "<string>",
  "status": "<string>",
  "ingestionJobId": "<string>",
  "startDate": "<string>",
  "endDate": "<string>",
  "tables": {},
  "filters": {
    "equals": {}
  },
  "errorMessage": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

{
  "code": "MTCH-0001",
  "title": "Bad Request",
  "message": "context not found",
  "error": "<string>",
  "details": {}
}

Autorizaciones

Authorization

string

header

requerido

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

Encabezados

X-Request-Id

string

A unique identifier for tracing the request across services.

Parámetros de ruta

connectionId

string

requerido

The unique identifier of the connection.

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; se requiere al menos una entrada

Show child attributes

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

Show child attributes

Respuesta

Solicitud de extracción creada

Una solicitud de extracción enviada a Fetcher

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

Show child attributes

filters

object

Filtros opcionales a nivel de fila para una extracción

Show child attributes

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

⌘I

Primeros pasos

API de Contextos de Configuración

API de Reglas de Coincidencia

API de Fuentes

API de Mapeo de Campos

API de Tablas de Tarifas

API de Configuración de Reglas de Tarifas

API de Programaciones

Flujo de excepciones

Acciones masivas

Comentarios

Credenciales de callback

API de Disputas

API de Trabajos de Exportación

API de Gobernanza

Trabajos de ingestión

Diseños y formatos

Revisiones de extracción

Extracción de documentos

Ejecuciones de matching

Matching manual y ajustes

Candidatos y partidas abiertas

Sugerencias de reglas

Panel y métricas

Informes

Exportaciones

Estado del descubrimiento

Conexiones de descubrimiento

Extracciones

Conexiones de agregadores

Webhooks de agregadores

Manejo de errores

Iniciar una extracción de conexión

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta