Primeiros Passos

Qual é a API da yube e como começar a utilizar.
Escrito por Suporte yube
Atualizado 1 semana atrás

A Yube disponibiliza para seus clientes e parceiros uma API pública para leitura e gestão dos dados armazenados da Yube.

Funcionamento da API

A API da Yube é desenvolvida utilizando o padrão GraphQL.

O GraphQL é um padrão de API que auxilia nas solicitações de leitura e escrita de dados, do qual utilizamos dois conceitos básicos:

- Query: Descrição das informações que o cliente deseja receber.

- Mutation: Descrição das informações que o cliente deseja enviar e receber como resposta.

Informações de Acesso

A Yube disponibiliza para seus clientes 2 ambientes: o ambiente de produção e de teste.

Ambiente de Produção

O ambiente de produção é o ambiente final de uso do RH, BPO e colaborador, sendo assim sempre tenha atenção quando for fazer alterações. A leitura dos dados não corre risco de gerar problemas.

Ambiente para Testes de Integração

O playground para exercícios e testes de integração é estruturado conforme abaixo:

Ambiente 1: Testes de Requisições e Schemas
Ambiente do tipo playground destinado à realização de testes de requisições e consulta aos schemas disponíveis.
Endpoint: https://api.yube.io

Ambiente 2: Testes de Autenticação, Conexão, Webhook e Status
Ambiente do tipo playground voltado à validação de autenticação, conexão, webhook e mudanças de status.
https://api.yube.io/graphql – Entrypoint da API GraphQL.
https://app.yube.io – Ambiente compartilhado que representa uma aplicação web do cliente, com estrutura simplificada dos recursos da plataforma.
https://m.yube.io – Representa a aplicação web do colaborador

Notas Importantes:

(i) O template disponibilizado conterá apenas três campos de texto, nomeados "Descrição Teste 1", "Descrição Teste 2", "Descrição Teste 3" → Não haverá campo para upload de documentos.
(ii) O ambiente compartilhado possui uma estrutura simplificada e não corresponde a uma réplica do ambiente de produção.
(iii) Dados reais não devem ser utilizados durante os testes. Utilize apenas dados fictícios e anonimizados.
(iv) O uso deste ambiente é restrito e por tempo determinado. Seu acesso poderá ser revogado ou encerrado a qualquer momento, conforme critérios Yube.
(v) Ao final do período de teste, todos os dados serão apagados.

Esse artigo foi útil?