As APIs de Relatórios do SkillUp permitem que você extraia programaticamente sinais de habilidades, distintivos e dados de certificação da sua organização. Essas APIs possibilitam integrar insights de aprendizagem com sistemas de RH, criar relatórios personalizados e conectar resultados de aprendizagem ao impacto nos negócios.

Pontos finais disponíveis

Configurando APIs de relatórios‬

As APIs do SkillUp usam o fluxo OAuth 2.0 Credenciais do Cliente para acesso seguro. Apenas sistemas autorizados podem solicitar e recuperar informações de relatórios.

Para configurar as APIs de relatórios:

‭Passo 1: Gerar Credenciais OAuth‬

1. ‭Faça login no SkillUp usando uma conta de administrador.

2. Clique no ícone do seu perfil no canto superior direito e selecione Configurações.

3. Clique em Registrar Nova Aplicação.

4. Digite um nome para sua aplicação.

5. Clique em Registrar Aplicação.

6. Copie o ID do Cliente e o Segredo do Cliente para a área de transferência ou clique em Download JSON para salvar as credenciais como um arquivo.

   Nota Importante: O segredo do cliente é exibido apenas uma vez durante a geração. Você deve armazená-lo com segurança antes de fechar a caixa de diálogo, pois não poderá recuperá-lo novamente.

Sua aplicação foi registrada com sucesso e você pode começar a fazer solicitações de API.

‭Etapa 2: Solicitar Token de Acesso‬

‭Como medida de segurança, você deve primeiro obter um token de acesso fazendo uma solicitação POST para o endpoint /v1/oauth2/token.

O cabeçalho de Autorização deve incluir suas credenciais de cliente codificadas em formato Base64.

1. Combine seu ID do cliente e segredo do cliente usando dois pontos (:).
   Exemplo: client_id:client_secret

2. Codifique a string usando Base64.

3. Adicione o prefixo Basic à string codificada para criar o cabeçalho de Autorização.
   Exemplo: Basic <string_base64_codificada>.

Exemplo

Se client_id = "abc123" e client_secret = "def456"
Combinação: “abc123:def456”

Codificado em Base64:”YWJjMTIzOmRlZjQ1Ng==”

Cabeçalho final:”Basic YWJjMTIzOmRlZjQ1Ng==”

Solicitação

curl -X POST https://www.hackerrank.com/skillup/api/v1/oauth2/token \
-H "Authorization: Basic <base64_encoded_credentials>" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials"

Cabeçalhos

Parâmetros do corpo

Resposta

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 600
}

‭Etapa 3: Acesse as APIs SkillUp‬

‭Depois de obter um token de acesso válido, use-o para chamar as APIs de Relatórios SkillUp.

Inclua o token no cabeçalho de Autorização da sua solicitação.

Exemplo de solicitação

curl -X GET https://www.hackerrank.com/skillup/api/v2/credentials \
-H "Authorization: Bearer <access_token>"

Tratamento de erros

Melhores práticas

• Armazene credenciais de forma segura. Nunca exponha credenciais do cliente no código do lado do cliente.

• Tokens permanecem válidos por 10 minutos. Armazene em cache e reutilize tokens de acesso em vez de gerar novos para cada solicitação

• Solicite um novo token antes que o atual expire.

Limites de taxa

Para mais informações, entre em contato com skillup-support@hackerrank.com.‭