Documentação da API

POST /get_categories

Resumo

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

Descrição

Utilize este endpoint para obter uma lista de categorias filtradas conforme os parâmetros passados na requisição.

---

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âmetro	Tipo	Descrição	Exemplo
access_token	string	Token de acesso (obrigatório).	b31643fc-a45f-448c-99ee-736a547f6989
unit_token	string	Token da unidade (obrigatório).	e6988e9e-b0c1-410c-ae08-aed7c64ac71f
type	string	Filtro de tipo de transação: "in" para categorias utilizadas em receitas, "out" para categorias utilizadas em despesas (obrigatório).	"in" ou "out"

---

Requisição de exemplo

curl -s 'https://portal.fipli.pro/api/v1/get_categories' -d '{"access_token": "b31643fc-a45f-448c-99ee-736a547f6989", "unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f", "type": "out"}' -H 'Content-Type: application/json' -H 'userlogged: <jwt>'

{
  "access_token": "b31643fc-a45f-448c-99ee-736a547f6989",
  "unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
  "type": "out"
}

Respostas

200 OK

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

{
  "success": true,
  "data": [
    {
      "module_type": "out", //tipo para despesa ou receita.
      "category": "13º Salário", //nome da categoria
      "note": "Despesas com o 13º salário do pessoal da empresa.", //descrição da categoria
      "token": "a6927665-6d56-4839-ad23-37d48717da13" //token único da categoria
    }
  ]
}

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"
}