Pular para o conteúdo principal
POST
/
v1
/
imports
/
contexts
/
{contextId}
/
sources
/
{sourceId}
/
mapping-proposal
Propor um mapeamento de mapa-de-campo/dialeto apenas em configuração para uma amostra de origem
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/mapping-proposal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sample": "<string>",
  "hints": {}
}
'
{
  "fields": [
    {
      "canonicalKey": "<string>",
      "confidence": 0.5,
      "rationale": "<string>",
      "sourceColumn": "<string>"
    }
  ],
  "dialect": {
    "dateStyle": "<string>",
    "decimalStyle": "<string>",
    "delimiter": "<string>",
    "encoding": "<string>"
  },
  "mapping": {}
}

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

contextId
string<uuid>
obrigatório

Context ID ID do contexto

sourceId
string<uuid>
obrigatório

Source ID ID da origem

Corpo

application/json
sample
string
obrigatório

Amostra representativa de arquivo de origem

Minimum string length: 1
Exemplo:

"id;value;ccy;posted_at\nA1;10,50;BRL;2025-06-01\n"

format
enum<string>

Dica de formato de arquivo declarado

Opções disponíveis:
csv,
json,
xml,
camt053
Exemplo:

"csv"

hints
object

Dicas de operador não secretas opcionais (ex.: locale=pt-BR, has_header=true)

Resposta

OK

fields
object[] | null
obrigatório

Detalhamento por campo que embasa o mapeamento proposto

dialect
object

Dialeto de origem proposto; null quando o advisor não tem sugestão de dialeto

mapping
object

Mapa de campo canônico proposto (chave canônica -> coluna de origem); null quando o advisor não pôde propor um mapeamento