Buscando tags vinculadas a um cliente
Developing
Sandbox
https://api.sandbox.neofin.services
Sandbox
https://api.sandbox.neofin.services
GET
https://api.sandbox.neofin.services
GET /tags/{customer_id}
Autenticação
| Header | Tipo | Obrigatório | Descrição |
|---|---|---|---|
api-key | string | Sim | Chave de API da Company |
secret-key | string | Sim | Chave secreta da Company |
Parâmetros de Rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
customer_id | string (UUID, document, integration_identifier) | Sim | Identificador interno do cliente na Neofin |
Respostas
200 OK — Cliente encontrado
customer_tags. Cada item contém o ID interno e o nome da tag.Se o cliente existir mas não possuir tags associadas,
customer_tags será um array vazio.{
"customer_tags": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"tag_name": "VIP"
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"tag_name": "Inadimplente"
}
]
}{
"customer_tags": []
}404 Not Found — Cliente não encontrado
customer_id informado é encontrado dentro da Company autenticada.{
"message": "Customer with ID: <customer_id> not found"
}Isolamento de tenant: A consulta é limitada à Company vinculada às credenciais enviadas no header. Um customer_idválido pertencente a outra Company também retornará404.
500 Internal Server Error
{
"message": "Problems get customer tags"
}Exemplo de Requisição
Request
Path Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.sandbox.neofin.services/customer/tags/'Response Response Example
200 - Example 1
{
"customer_tags": [
{
"id": "string",
"tag_name": "string"
}
]
}