Skull Book — Documentação do Operador

Como funciona

Comece aqui — da credencial à primeira aposta

1. Receba suas credenciais

   No provisionamento você recebe: a publishable key (pk_…, pública, identifica sua casa no bootstrap), o registro da sua chave de assinatura ES256 (você gera o par; só a pública fica conosco) e uma API key para a API server-to-server (opcional). As origens (domínios) do seu site são verificadas — o widget só é servido nelas.

2. Implemente o endpoint de handoff no seu backend

   É o único código obrigatório do seu lado. Quando o widget pede, seu backend valida a sessão first-party do apostador logado e devolve um JWT curto:

   # Python (PyJWT + cryptography) — o mesmo código do sandbox
   import time, uuid, jwt
   
   def assinar_handoff(frame_id: str, origin: str, apostador_id: str,
                       cpf: str, chave_privada_pem: str, kid: str) -> str:
       agora = int(time.time())
       return jwt.encode(
           {
               "aud": "skull-embed",
               "sub": apostador_id,        # o id DELE no SEU sistema
               "cpf": cpf,                 # obrigatório para apostar (KYC)
               "jti": uuid.uuid4().hex,
               "iat": agora,
               "exp": agora + 60,          # 60s: o handoff é de uso imediato
               "frame_id": frame_id,       # vem do widget, ligado à origem
               "origin": origin,
           },
           chave_privada_pem, algorithm="ES256", headers={"kid": kid})
   

   O frame_id nasce no nosso servidor ligado à origem observada; assinar um handoff para ele não autentica nada além daquele iframe naquela página.

3. Cole o snippet no seu site

   <div id="skull-widget"></div>
   <script src="https://embed-sandbox.skull-api.xyz/SEU_SLUG/widget.js"></script>
   <script>
     window.SkullBook.init({
       container: 'skull-widget',
       publishableKey: 'pk_SUA_CHAVE',
       getHandoff: function (frameId, origin) {
         return fetch('/handoff', {          // o endpoint do passo 2
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({ frame_id: frameId, origin: origin })
         }).then(r => r.json()).then(corpo => corpo.handoff);
       },
       onBet: function (bilhete) { /* aposta aceita */ },
       onError: function (erro) { /* mostrar/registrar */ }
     });
   </script>

   O iframe se auto-dimensiona; o container só precisa de largura. Abaixo de 780px o widget troca sozinho para o modo mobile.

4. Teste no sandbox

   O sandbox é este ambiente: dinheiro fake, dados REAIS de eventos ao vivo. Veja funcionando em https://demo.skull-api.xyz — aquela página é exatamente o snippet acima mais um /handoff de exemplo. Depósito Pix se simula por POST https://demo.skull-api.xyz/sandbox/pix/pagar.

5. Escolha o que ofertar

   Por padrão sua casa oferta todos os mercados integrados (tabela abaixo). Para ocultar mercados do seu iframe, a lista hidden_markets da sua conta faz as três coisas de uma vez: a grade do widget deixa de mostrá-los, a cotação recusa e o POST /bets responde 422. Uma decisão, três superfícies.

6. (Opcional) Aposte por API server-to-server

   Se você tem front próprio, o POST https://book-sandbox.skull-api.xyz/bets com X-API-Key usa a MESMA máquina de cotação/risco/liquidação do widget. Referência completa no Swagger da API do book.

Mercados integrados (83)

Esta tabela é renderizada do mesmo artefato que os gates de oferta e de aposta consomem neste deploy — ela não tem como divergir do que a API aceita. A sintaxe é contrato: selection_key e params do seu pedido são validáveis contra ela. Mercado fora desta lista não é ofertado nem aceito.

"Prova": N acordos = liquidação conferida contra o desfecho publicado pela própria fonte, com N confirmações e zero divergências; autoridade única = mercado cuja fonte é a única testemunha do dado (decisão explícita de produto).

Liquidação e conciliação

Referências

• API do book (Swagger) — embed, apostas S2S e administração. (openapi.json)
• API de dados (Swagger) — eventos, odds, histórico e o catálogo de mercados (GET https://api.skull-api.xyz/api/v3/markets, requer API key).
• Casa Demo — a integração de referência, viva.

Skull Book · documentação gerada do mesmo build que atende as requisições — o que está escrito aqui é o que o sistema faz.