Listamos aqui alguns possíveis erros e as soluções que podem ocorrer ao utilizar a API para realizar alguma ação ou obter dados:
🔎Erro de "Token Invalido"
Para esse tipo de erro verifique os "header(s)". Dois itens são obrigatórios: Authorization e Content-Type.
> "Authorization": "Bearer USER_TOKEN",
> "Content-Type": "application/json"
Para o token o usuário precisa do token "mais longo" ou seja, não é o token da tela de usuário, e sim a da https://app.pipefy.com/tokens
É bem comum não adicionar o Bearer antes do token ou adicionar o token com aspas, então, basta adicionar o Bearer ou remover as aspas do token. Ex: "Barier 'token' "
Para sistemas terceiros como o Postman, o uso correto é este aqui:
🔎Uso errado do link
Às vezes o link utilizado pode ser https://app.pipefy.com/graphiql ou app.pipefy.com/graphiql ao invés de https://api.pipefy.com/graphql no cabeçalho, e isso também retorna um erro de permissão.
🔎Problemas no código
Neste caso, você pode acessar a página de developer -> example para e verificar o formato das chamadas: https://developers.pipefy.com/reference#graphql-endpoint
1) Cole a query do graphiql ali
2) Cole Bearer USER_TOKEN
3) Cole application/json
4) Veja quais as linguagens disponíveis para verificar o exemplo.
🔎Erros de campo
Erros de campo normalmente são um problema de tipo:
-
Tipo de campo: "assignee", Exemplo de valor:[00000, 00001] 👉 ID do usuário
-
Tipo de campo: "checklist_vertical", Exemplo de valor: ["a", "b"] 👉 Valores precisam ser idênticos aos das options do campo.
-
Tipo de campo: "checklist_horizontal", Exemplo de valor: ["b"] 👉 Valores precisam ser idênticos aos das options do campo.
-
Tipo de campo: "cpf", Exemplo de valor: "123.456.789-00"
-
Tipo de campo: "cnpj", Exemplo de valor: "12.345.678/1234-00"
-
Tipo de campo: "date", Exemplo de valor: "1977-01-20"
-
Tipo de campo: "date_time", Exemplo de valor: "2017-07-20T21:00:00+00:00"
-
Tipo de campo: "due_date", Exemplo de valor: "2017-07-20T21:00:00+00:00"
-
Tipo de campo: "currency", Exemplo de valor: "9500.50"
-
Tipo de campo: "label_select", Exemplo de valor: [890073, 908006] 👉 Valores precisam ser do ID da label (tem como ver em queries de consulta)
-
Tipo de campo: "email", Exemplo de valor: "rocky.balboa@email.com"
-
Tipo de campo: "number", Exemplo de valor: 9000
-
Tipo de campo: "short_text", Exemplo de valor: "Rocky Balboa"
-
Tipo de campo: "long_text", Exemplo de valor: " any text any text any text any text."
-
Tipo de campo: "radio_vertical", Exemplo de valor: "yes" 👉 Apenas uma opção e idêntica a opção do campo
-
Tipo de campo: "radio_horizontal", Exemplo de valor: "no" 👉 Apenas uma opção e idêntica a opção do campo
-
Tipo de campo: "phone", Exemplo de valor: "+55 11 1234-5678"
-
Tipo de campo: "select", Exemplo de valor: "B. Rocky Balboa II" 👉 Apenas uma opção e idêntica a opção do campo
-
Tipo de campo: "time", Exemplo de valor: "17:25"