Pular para o conteúdo principal
POST
/
v1
/
discovery
/
connections
/
{connectionId}
/
extractions
Iniciar uma extração de conexão
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"
}

Autorizações

​
Authorization
string
header
obrigatório

Autenticação por Bearer token (formato: "Bearer {token}")

Cabeçalhos

​
X-Request-Id
string

Um identificador único para rastrear a requisição entre os serviços.

Parâmetros de caminho

​
connectionId
string
obrigatório

O identificador único da conexão.

Corpo

application/json

Payload da requisição de extração

Payload da requisição para iniciar uma extração de dados a partir de uma conexão descoberta

​
tables
object
obrigatório

Tabelas das quais extrair dados, indexadas pelo nome da tabela

​
startDate
string

Início do intervalo de datas a extrair (RFC 3339)

​
endDate
string

Fim do intervalo de datas a extrair (RFC 3339)

​
filters
object

Filtros opcionais em nível de linha para uma extração

Resposta

Requisição de extração criada

Uma requisição de extração enviada ao Fetcher

​
id
string

Identificador interno da requisição de extração

​
connectionId
string

Conexão para a qual esta extração foi enviada

​
status
string

Status atual do ciclo de vida da extração

​
ingestionJobId
string

Identificador do job retornado pelo Fetcher

​
startDate
string

Início do intervalo de datas extraído

​
endDate
string

Fim do intervalo de datas extraído

​
tables
object

Status de extração por tabela

​
filters
object

Filtros opcionais em nível de linha para uma extração

​
errorMessage
string

Detalhes do erro caso a extração tenha falhado

​
createdAt
string

Timestamp em que a extração foi solicitada

​
updatedAt
string

Timestamp da última atualização de status

​
bridgeAttempts
integer

Número de vezes que o pipeline bridge do Matcher tentou recuperar e ingerir esta extração

Exemplo:

0

​
bridgeLastError
string

Classe de erro da última falha do pipeline bridge

Exemplo:

""

​
bridgeLastErrorMessage
string

Mensagem de erro com histórico acumulado do pipeline bridge; a falha primária permanece no início

Exemplo:

""

​
bridgeFailedAt
string<date-time> | null

Timestamp da primeira falha terminal do bridge; omitido quando nenhuma falha ocorreu

​
custodyDeletedAt
string<date-time> | null

Timestamp em que o objeto de custódia foi excluído; omitido quando ainda retido