Habilitar una configuración de provider

curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable', 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://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "name": "ClearSale Production",
  "description": "ClearSale anti-fraud for Pix transactions",
  "providerId": "clearsale",
  "kind": "catalog",
  "config": {
    "baseUrl": "https://api.clearsale.com.br",
    "environment": "production"
  },
  "allowedHosts": [
    "api.clearsale.com.br"
  ],
  "schemaBindings": [],
  "status": "active",
  "metadata": {
    "team": "risk"
  },
  "createdAt": "2026-03-17T14:00:00Z",
  "updatedAt": "2026-03-17T14:00:00Z"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

POST

provider-configurations

{id}

enable

Habilitar una configuración de provider

curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable', 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://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flowker.sandbox.lerian.net/v1/provider-configurations/{id}/enable")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "name": "ClearSale Production",
  "description": "ClearSale anti-fraud for Pix transactions",
  "providerId": "clearsale",
  "kind": "catalog",
  "config": {
    "baseUrl": "https://api.clearsale.com.br",
    "environment": "production"
  },
  "allowedHosts": [
    "api.clearsale.com.br"
  ],
  "schemaBindings": [],
  "status": "active",
  "metadata": {
    "team": "risk"
  },
  "createdAt": "2026-03-17T14:00:00Z",
  "updatedAt": "2026-03-17T14:00:00Z"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

Autorizaciones

Authorization

string

header

requerido

Token bearer JWT emitido por el provider de identidad. Envíalo en la cabecera Authorization como Bearer <token>.

Parámetros de ruta

string<uuid>

requerido

Identificador único de la configuración de provider.

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados.

config

object

requerido

Configuración específica del provider.

Show child attributes

Ejemplo:

{
  "baseUrl": "https://api.clearsale.com.br",
  "environment": "production"
}

createdAt

string<date-time>

requerido

Marca de tiempo de cuando se creó la configuración.

Ejemplo:

"2026-03-17T14:00:00Z"

string<uuid>

requerido

Identificador único de la configuración.

Ejemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

kind

enum<string>

requerido

Tipo de conexión de esta configuración: catalog apunta a un provider publicado en el catálogo, y external_openapi apunta a un documento OpenAPI registrado en tu tenant.

Opciones disponibles:

catalog,

external_openapi

Ejemplo:

"catalog"

name

string

requerido

Nombre de la configuración.

Ejemplo:

"ClearSale Production"

providerId

string

requerido

ID del provider del catálogo al que apunta esta configuración. Una configuración de kind external_openapi creada sin uno lleva en su lugar el id reservado external.openapi.

Ejemplo:

"clearsale"

schemaBindings

object[]

requerido

Esquemas almacenados a los que se vincula esta configuración. El campo siempre aparece, y es una lista vacía cuando la configuración no vincula ningún esquema.

Show child attributes

status

enum<string>

requerido

Estado actual: active o disabled.

Opciones disponibles:

active,

disabled

Ejemplo:

"active"

updatedAt

string<date-time>

requerido

Marca de tiempo de la última actualización.

Ejemplo:

"2026-03-17T14:00:00Z"

allowedHosts

string[]

Lista de hosts de destino permitidos para las llamadas salientes. El campo no aparece cuando la configuración no declara ninguna lista.

Maximum array length: 100

Maximum string length: 253

Ejemplo:

["api.clearsale.com.br"]

allowedPrivateHosts

string[]

Hosts privados con nombre que esta configuración puede alcanzar, gestionados por tu equipo de operaciones. El campo no aparece cuando el conjunto está vacío.

Maximum array length: 100

Maximum string length: 253

Ejemplo:

["nginx.pix-inline.internal"]

description

string

Descripción legible por humanos.

Ejemplo:

"ClearSale anti-fraud for Pix transactions"

metadata

object

Metadatos personalizados.

Show child attributes

Ejemplo:

{
  "environment": "production",
  "team": "risk"
}

⌘I

Primeros pasos

API de Catálogo

API de Workflows

API de Programación

API de Ejecuciones

API de Dashboards

API de Configuraciones de Executor

API de Configuraciones de Provider

API de Registro de Esquemas

API de Esquemas OpenAPI

API de Esquemas XSD

API de Webhooks

Manejo de errores

Habilitar una configuración de provider

Autorizaciones

Parámetros de ruta

Respuesta