Pular para o conteúdo principal
POST
/
v1
/
provider-configurations
Criar uma configuração de provedor
curl --request POST \
  --url https://flowker.sandbox.lerian.net/v1/provider-configurations \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "config": {
    "baseUrl": "https://api.clearsale.com.br",
    "apiKey": "cs-key-abc123",
    "environment": "production"
  },
  "name": "ClearSale Production",
  "providerId": "clearsale",
  "description": "ClearSale anti-fraud for Pix transactions",
  "metadata": {
    "environment": "production",
    "team": "risk"
  }
}
'
{
  "createdAt": "2026-03-17T14:00:00Z",
  "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "name": "ClearSale Production",
  "status": "active"
}

Autorizações

​
X-API-Key
string
header
obrigatório

API key for authenticating requests to the Flowker API. Provisioned via the API_KEY environment variable during deployment.

Corpo

application/json

Corpo da solicitação contendo os detalhes da configuração do provedor.

​
config
object
obrigatório

Configuração específica do provedor que é validada contra o JSON Schema do provedor.

Exemplo:
{
  "baseUrl": "https://api.clearsale.com.br",
  "apiKey": "cs-key-abc123",
  "environment": "production"
}
​
name
string
obrigatório

Nome único para esta configuração de provedor.

Required string length: 1 - 100
Exemplo:

"ClearSale Production"

​
providerId
string
obrigatório

ID do provedor do catálogo a ser configurado. Deve corresponder a um provedor registrado.

Exemplo:

"clearsale"

​
description
string

Descrição legível por humanos desta configuração de provedor.

Maximum string length: 500
Exemplo:

"ClearSale anti-fraud for Pix transactions"

​
metadata
object

Pares chave-valor personalizados para etiquetagem.

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

Resposta

Indica que o recurso foi criado com sucesso e a operação foi concluída conforme esperado.

​
createdAt
string<date-time>

Marca temporal de quando a configuração foi criada.

Exemplo:

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

​
id
string<uuid>

Identificador único da configuração criada.

Exemplo:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

​
name
string

Nome da configuração.

Exemplo:

"ClearSale Production"

​
status
string

Status inicial (sempre active na criação).

Exemplo:

"active"