Pular para o conteúdo principal

Documentação da API

POST /get_status​

Resumo​

Este endpoint retorna status com base nos parâmetros fornecidos pelo usuário.

Descrição​

Utilize este endpoint para obter uma lista de status conforme os parâmetros passados na requisição. Ele é especialmente útil para definir o parâmetro id_action na inserção ou atualização de uma despesa ou receita.

Requisição​

Body da Requisição​

O corpo da requisição deve ser um objeto JSON e é obrigatório. A seguir estão os parâmetros aceitos:

ParâmetroTipoDescriçãoExemplo
access_tokenstringToken de acesso (obrigatório).aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
unit_tokenstringToken da unidade (obrigatório).aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Requisição de exemplo​

curl -s 'https://portal.fipli.pro/api/v1/get_status' -d '{"access_token": "<access_token>", "unit_token": "<unit_token>"}' -H 'Content-Type: application/json'
{
  "access_token": "<access_token>",
  "unit_token": "<unit_token>"
}

Respostas​

200 OK​

Em caso de sucesso, a resposta terá o seguinte formato:

{
  "success": true,
  "data": [
    {
      "code": "3", // Código identificador do status (pode representar um estágio específico em um fluxo)
      "name": "Aprovado" // Nome descritivo do status
    }
  ]
}

4xx e 5xx Erros​

Em caso de erro, success sera igual a false, seguido por uma menssagem de erro, por exemplo:

{ 
  "success": false, 
  "error": "Missing parameters"
}