Emitir una credencial de callback

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalSystem": "<string>"
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials"

payload = { "externalSystem": "<string>" }
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({externalSystem: '<string>'})
};

fetch('https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials', 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/exceptions/callbacks/credentials",
  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([
    'externalSystem' => '<string>'
  ]),
  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/exceptions/callbacks/credentials"

	payload := strings.NewReader("{\n  \"externalSystem\": \"<string>\"\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/exceptions/callbacks/credentials")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalSystem\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials")

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  \"externalSystem\": \"<string>\"\n}"

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

{
  "createdAt": "<string>",
  "credentialId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "token": "<string>",
  "externalSystem": "<string>",
  "webhookUrlHint": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

POST

exceptions

callbacks

credentials

Emitir una credencial de callback

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalSystem": "<string>"
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials"

payload = { "externalSystem": "<string>" }
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({externalSystem: '<string>'})
};

fetch('https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials', 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/exceptions/callbacks/credentials",
  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([
    'externalSystem' => '<string>'
  ]),
  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/exceptions/callbacks/credentials"

	payload := strings.NewReader("{\n  \"externalSystem\": \"<string>\"\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/exceptions/callbacks/credentials")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"externalSystem\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/exceptions/callbacks/credentials")

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  \"externalSystem\": \"<string>\"\n}"

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

{
  "createdAt": "<string>",
  "credentialId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "token": "<string>",
  "externalSystem": "<string>",
  "webhookUrlHint": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Autorizaciones

Authorization

string

header

requerido

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

Cuerpo

application/json

externalSystem

string

Etiqueta opcional legible por el operador para el sistema externo que autentica esta credencial (p. ej. "stripe", "billing-gw")

Maximum string length: 128

Ejemplo:

"stripe"

Respuesta

Creado

createdAt

string

requerido

Hora de emisión (RFC 3339, UTC)

credentialId

string<uuid>

requerido

ID sustituto de la credencial emitida

token

string

requerido

Token bearer sin procesar, expuesto exactamente una vez; configúrelo como el valor del encabezado X-Callback-Token en el sistema externo. Solo su hash SHA-256 se almacena en el servidor.

externalSystem

string

Etiqueta de sistema externo legible por el operador, repetida para confirmación

webhookUrlHint

string

Forma informativa de la URL de callback entrante a configurar en el sistema externo. El marcador {exceptionId} se rellena por callback.

⌘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

Emitir una credencial de callback

Autorizaciones

Cuerpo

Respuesta