Erros API - Causas e Soluções

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"