Listar chaves de API

Endpoint: GET /integrations/apikeys/{seller_id}/apikeys/

Autenticação: token JWT obrigatório. Diferentemente dos endpoints de webhooks, este endpoint rejeita autenticação por chave de API — não é possível usar uma chave de API para enumerar as demais chaves do vendedor. Consulte Autenticação.

Retorna todas as chaves de API associadas ao seller_id. O valor secreto (key) nunca é incluído nesta resposta — ele é retornado apenas uma única vez, no momento da criação por Criar chave de API. Se você perder uma chave, é necessário removê-la e criar uma nova.

Parâmetros de caminho

string (uuid)

required

Identificador do vendedor. As chaves são filtradas por seller_id; não há verificação adicional de propriedade além da autenticação por JWT.

Resposta

Retorna um array com os descritores das chaves de API.

string (uuid)

ID da chave de API. Use-o para buscar, atualizar ou remover.

string

Rótulo legível.

string

Descrição livre.

boolean

Quando false, o token correspondente é rejeitado na autenticação mesmo se apresentado. Use active=false como desativação suave em vez de remoção.

[
  {
    "id": "c4f1e8a3-7d92-4b6f-9e10-2a3b4c5d6e7f",
    "name": "Servidor de produção",
    "description": "Utilizada pelo backend de checkout do vendedor",
    "active": true
  }
]

Erros

Status	Quando
`401`	JWT ausente ou inválido (ou tentativa de uso de chave de API — não aceita neste endpoint).

Exemplos

curl https://api.dlpay.cloud/integrations/apikeys/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/apikeys/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    "https://api.dlpay.cloud/integrations/apikeys/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/apikeys/",
    headers={"Authorization": f"Bearer {access_token}"},
)
keys = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/integrations/apikeys/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/apikeys/",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const keys = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Listar chaves de API

Parâmetros de caminho

Resposta

Erros

Exemplos

​Parâmetros de caminho

​Resposta

​Erros

​Exemplos

Parâmetros de caminho

Resposta

Erros

Exemplos