Remover clientes

DELETE /api/company/v1/{company_role_id}/customers/{id}

O que este endpoint faz

Este endpoint remove ou cancela o vínculo de clientes quando permitido pelas regras de negócio. Ele pertence ao domínio de cadastro, dados operacionais, documentos, usuários e permissões por empresa.

Use DELETE /api/company/v1/{company_role_id}/customers/{id} quando a integração precisar acionar esse comportamento exatamente como o app da Antecipa Fácil faz pelo gateway público. A rota depende de company_role_id, id, então a chamada deve ser feita no contexto correto da empresa, título ou recurso informado.

Para que serve

Ele ajuda a compor fluxos de integração do backend do parceiro com a plataforma, mantendo autenticação via Bearer token e tráfego pelo APIM. Consulte os parâmetros, corpo de requisição e respostas desta página antes de usar em produção.

Gateway

Chame sempre https://api.antecipafacil.net.br/api/company/v1/{company_role_id}/customers/{id}. O APIM repassa a rota para o backend correto; serviços internos não devem ser chamados diretamente.

Parâmetros

company_role_id path obrigatório

Valor usado para compor a chamada deste endpoint.

id path obrigatório

Valor usado para compor a chamada deste endpoint.

Respostas

204 Operação executada com sucesso.

Try it DELETE

URL Bearer token Try it!

Clique em Try it! para executar a chamada pelo navegador.

Exemplos

ShellNodeDenoPythonC#Rust

curl --request DELETE \
  --url 'https://api.antecipafacil.net.br/api/company/v1/123/customers/123' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer <access_token>'

const response = await fetch('https://api.antecipafacil.net.br/api/company/v1/123/customers/123', {
  method: 'DELETE',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer <access_token>',
  },
});

const data = await response.json();
console.log(data);

const response = await fetch('https://api.antecipafacil.net.br/api/company/v1/123/customers/123', {
  method: 'DELETE',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer <access_token>',
  },
});

console.log(await response.json());

import requests

url = "https://api.antecipafacil.net.br/api/company/v1/123/customers/123"
headers = {
    "accept": "application/json",
    "Authorization": "Bearer <access_token>",
}

response = requests.delete(url, headers=headers)
response.raise_for_status()
print(response.json())

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Delete, "https://api.antecipafacil.net.br/api/company/v1/123/customers/123");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<access_token>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

let client = reqwest::Client::new();
let response = client
    .request(reqwest::Method::DELETE, "https://api.antecipafacil.net.br/api/company/v1/123/customers/123")
    .bearer_auth("<access_token>")
    .header("accept", "application/json")
    .send()
    .await?;

let body = response.text().await?;
println!("{}", body);

Copiar exemplo