Conceder acesso

Endpoint: POST /user/{user_id}/legacy/accesses/

Autenticação: JWT obrigatório

Cria um novo registro na tabela de acessos para user_id. O campo seller aceita tanto o identificador de um vendedor (legado) quanto o de uma conta unificada — o servidor tenta vendedor primeiro e, se não encontrar, busca pela conta. O group define as permissões que o usuário terá nesse escopo.

Pré-requisitos

O usuário-alvo precisa existir. Crie um via POST /user/register/ ou POST /user/users/.
O vendedor ou a conta unificada-alvo precisam existir.
O grupo-alvo precisa existir. Crie grupos via POST /user/groups/.
Quem faz a chamada precisa ser superusuário ou possuir a permissão auth.manage_accesses.

Parâmetros de rota

integer

required

Identificador do usuário que receberá a concessão de acesso.

Corpo da requisição

string

required

Identificador de vendedor (legado) ou de conta unificada. O servidor resolve para o que corresponder.

integer

required

Identificador do grupo que define o conjunto de permissões para este acesso.

Resposta

201 Created com o novo acesso (formato resumido de criação).

integer

string

Ecoa o valor enviado.

integer

Ecoa o identificador do grupo enviado.

string

{
  "id": 12,
  "seller": "8f6c7e8a-...-...",
  "group": 3,
  "created_at": "2026-05-14T09:00:00.000000Z",
  "updated_at": "2026-05-14T09:00:00.000000Z"
}

Erros

Status	Quando
`400`	`seller` não corresponde a nenhum vendedor ou conta (“Seller or Account not found.”), `group` não existe (“Group not found.”) ou `user_id` não corresponde a nenhum usuário (“User not found.”).
`401`	Token ausente ou inválido.
`403`	Quem chama não possui `auth.manage_accesses` e não é superusuário.

Exemplos

curl -X POST https://api.dlpay.cloud/user/42/legacy/accesses/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"seller": "8f6c7e8a-...-...", "group": 3}'

import requests

response = requests.post(
    "https://api.dlpay.cloud/user/42/legacy/accesses/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"seller": account_id, "group": 3},
)
access = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/user/42/legacy/accesses/",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ seller: accountId, group: 3 }),
  },
);
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

Corpo da requisição

Resposta

Erros

Exemplos

​Pré-requisitos

​Parâmetros de rota

​Corpo da requisição

​Resposta

​Erros

​Exemplos

Pré-requisitos

Parâmetros de rota

Corpo da requisição

Resposta

Erros

Exemplos