A API Hypetech busca respeitar a terminologia Provably Fair. Nesse sentido, nossos jogos possuem alto grau de confiabilidade.

Seguindo as normas definidas, nosso sistema possui as seguintes características:

• Jogo justo
• Responsabilidade
• Anti-trapaça garantido
• Pagamentos instantâneos
• Abertura da plataforma

Para obter acesso aos games fornecidos pela Hypetech entre em contato com a equipe de suporte através do email informado no cabeçalho.

A API Hypetech retorna códigos de status HTTP para indicar sucesso ou falhas das requisições. Códigos 2xx indicam sucesso. Códigos 4xx indicam falhas causadas pelas informações enviadas pelo cliente ou pelo estado atual das entidades. Códigos 5xx indicam problemas no serviço no lado da API Hypetech. As respostas de erro incluem no corpo detalhes do erro seguindo o schema da RFC 7807. O objetivo primário é apenas e tão somente identificar o tipo de erro.

Abaixo estão listados os tipos de erro e possíveis violações da API Hypetech.

Esta seção reúne erros que poderiam ser retornados por quaisquer endpoints listados na API Hypetech.

Bad Request

• Significado: Requisição inválida.
• HTTP Status Code: 400 Bad Request.

Forbiden

• Significado: Requisição de participante autenticado que viola alguma regra de autorização.
• HTTP Status Code: 403 Forbidden.

Not Found

• Significado: Entidade não encontrada.
• HTTP Status Code: 404 Not Found.

Gone

• Significado: Indica que a entidade existia, mas foi permanentemente removida.
• HTTP Status Code: 410 Gone.

Internal Server Error

• Significado: Condição inesperada ao processar requisição.
• HTTP Status Code: 500 Internal Server Error.

Service Unavailable

• Significado: Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.
• HTTP Status Code: 503 Service Unavailable.

Gateway Timeout

• Significado: Indica que o serviço demorou além do esperado para retornar.
• HTTP Status Code: 504 Gateway Timeout.

Esta seção contém informações sobre como configurar webhooks no lado do cliente. Esses endpoints fornecerão as informações necessárias para integração com a API Hypetech, através da consulta de saldo do usuário, registro de apostas e confirmação de saques nos jogos.

Para garantir a integridade e autenticidade dos dados transmitidos através de nossos webhooks, incluímos um header de assinatura em cada solicitação. Este header permite que você verifique se a solicitação foi realmente enviada por nós e que os dados não foram alterados durante a transmissão.

Header de Assinatura

Cada webhook enviado por nós incluirá um header chamado Hype-Hash. O valor deste header é uma assinatura HMAC-SHA256, gerada a partir da combinação da URL e do corpo da solicitação.

Como a Assinatura é Gerada

A assinatura é criada usando a seguinte função:

import * as crypto from 'crypto';

export function createHmacSha256(secret: string, url: string, data: any): string {
  const message = url + JSON.stringify(data);
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(message);
  return hmac.digest('hex');
}

Funcionamento da Função

A função aceita três parâmetros:

• secret: A chave de API atual do cliente, que atua como a chave secreta.
• url: A URL da solicitação do webhook.
• data: O corpo da solicitação do webhook.

A URL e o corpo da solicitação (convertido em uma string JSON) são concatenados para formar a mensagem.

Esta mensagem é assinada usando HMAC-SHA256 com a chave de API do cliente.

A assinatura resultante é retornada como uma string hexadecimal.

Como Verificar a Assinatura

Para verificar a assinatura recebida em um webhook:

1. Extraia o valor do header Hype-Hash da solicitação recebida.
2. Usando sua chave de API atual (que atua como a chave secreta) e a função createHmacSha256, gere sua própria assinatura com base na URL e no corpo da solicitação recebida.
3. Compare a assinatura que você gerou com o valor do header Hype-Hash. Se eles corresponderem, a solicitação é autêntica e não foi alterada durante a transmissão.

Nota: Qualquer parte que possua sua chave de API poderá gerar ou verificar assinaturas, por isso, nunca a compartilhe ou a exponha publicamente.

Exemplo de Headers Recebidos:

{
  'Content-Type': 'application/json',
  'Accept-Encoding': 'application/json',
  'Hype-Hash': '35d334e534211b109e2563c8bd4c945ce1055c9fbc0a6dc01efa7d2338df4e0e'
}

Este endpoint é responsável por receber dados relacionados ao usuário da plataforma do cliente e ao jogo que será exibido. Para obter acesso a um jogo específico, entre em contato com a equipe de suporte no e-mail especificado no cabeçalho do documento, se tudo correr bem eles irão informar o game_token para permitir o acesso ao jogo na plataforma.