Documentação da API
POST /disable_category
Resumo
Este endpoint permite desativar uma categoria existente em uma unidade específica.
Descrição
Utilize este endpoint para desativar uma categoria cadastrada anteriormente, tornando-a inativa para a unidade informada. A categoria não será excluída do banco de dados, apenas marcada como inativa.
Requisição
Body da Requisição
O corpo deve ser um objeto JSON com os seguintes parâmetros:
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
access_token | string | Sim | Token de autenticação do usuário. | b31643fc-a45f-448c-99ee-736a547f6989 |
unit_token | string | Sim | Token identificador da unidade. | e6988e9e-b0c1-410c-ae08-aed7c64ac71f |
token | string | Sim | Token identificador da categoria a ser desativada. | a6927665-6d56-4839-ad23-37d48717da13 |
Exemplo de Requisição
Curl
curl -X POST 'https://portal.fipli.pro/api/v1/disable_category' \
-H 'Content-Type: application/json' \
-d '{
"access_token": "b31643fc-a45f-448c-99ee-736a547f6989",
"unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
"token": "a6927665-6d56-4839-ad23-37d48717da13"
}'
Resposta
200 OK
Desativação realizada com sucesso.
{
"success": true,
"message": "Category disabled successfully"
}
Erros Comuns
| Status | Mensagem | Descrição |
|---|---|---|
400 | "Missing parameters" | Algum parâmetro obrigatório não foi enviado na requisição. |
403 | "Invalid data" | Token inválido ou não autorizado. |
404 | "Category not found" | A categoria com o token fornecido não foi encontrada. |
500 | "Something went wrong. Please try again later." | Erro interno no servidor. |
Observações
- A desativação é lógica, a categoria permanece no banco de dados.
- A operação é vinculada à unidade informada.
- Certifique-se de que os tokens utilizados estejam válidos e atualizados.