Pular para o conteúdo principal

Documentação da API

POST /get_projects​

Resumo​

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

Descrição​

Utilize este endpoint para obter uma lista de projetos filtrados 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â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_projects' -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": [
    {
      "token": "<token>", //token único do projeto
      "name": "<name>", //nome do projeto
      "observation": "<observation>", //descrição do projeto
      "budget": 30000 //orçamento estimado do projeto
    }
  ]
}

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