Buscar acesso

Endpoint: GET /user/{user_id}/legacy/accesses/{id}/

Autenticação: JWT obrigatório

Retorna um único registro de acesso vinculado ao usuário informado. O formato da resposta é o mesmo do endpoint de listagem — vendedor, conta e grupo com todas as permissões.

Pré-requisitos

Quem faz a chamada precisa estar autenticado. A ação retrieve exige apenas autenticação.

Parâmetros de rota

integer

required

Identificador do usuário dono do acesso.

integer

required

Identificador do registro de acesso.

Resposta

integer

object

Vendedor legado { id, display_name, type }, ou null.

object

Conta unificada { id, display_name, type }, ou null.

object

{ id, name, permissions: [...] }.

string

{
  "id": 12,
  "seller": null,
  "account": {
    "id": "8f6c7e8a-...-...",
    "display_name": "Acme Café",
    "type": "MERCHANT"
  },
  "group": {
    "id": 3,
    "name": "Account Admin",
    "permissions": [
      { "id": 101, "name": "Manage Users", "codename": "manage_users" }
    ]
  },
  "created_at": "2025-03-04T18:00:00.000000Z",
  "updated_at": "2025-03-04T18:00:00.000000Z"
}

Erros

Status	Quando
`401`	Token ausente ou inválido.
`404`	Nenhum acesso encontrado para o par `user_id` + `id`.

Exemplos

curl https://api.dlpay.cloud/user/42/legacy/accesses/12/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import requests

response = requests.get(
    "https://api.dlpay.cloud/user/42/legacy/accesses/12/",
    headers={"Authorization": f"Bearer {access_token}"},
)
access = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/user/42/legacy/accesses/12/",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const access = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Resposta

Erros

Exemplos