Ambiente de teste (sandbox)

Use o sandbox para desenvolver e testar a integração sem mexer nos dados reais. Ele roda a mesma versão da API de produção.

	Produção	Sandbox
URL base	https://api.idlebazaar.com	https://sandbox.api.idlebazaar.com
Dados	reais	cópia da produção, refeita toda madrugada

Como funciona

• Todo dia às 3h (horário de Brasília) o banco do sandbox é substituído por uma cópia da produção.
• Tudo o que você fizer no sandbox (votos resgatados, chaves geradas, ofertas) é apagado na cópia seguinte.
• A sua chave de votos de produção funciona no sandbox, porque as chaves vêm junto na cópia. Uma chave gerada no sandbox só vale lá, e até a madrugada.
• O sandbox não envia e-mails e não aceita upload de imagens.

Trocando de ambiente

Deixe a URL base numa variável de ambiente do servidor do jogo:

.env

# desenvolvimento
IDLEBAZAAR_API=https://sandbox.api.idlebazaar.com
# produção
# IDLEBAZAAR_API=https://api.idlebazaar.com

Node.js

const API = `${process.env.IDLEBAZAAR_API}/v1/public/games/${process.env.IDLEBAZAAR_GAME_ID}`

PHP

<?php
$api = getenv('IDLEBAZAAR_API') . '/v1/public/games/' . getenv('IDLEBAZAAR_GAME_ID');

Python

API = f"{os.environ['IDLEBAZAAR_API']}/v1/public/games/{os.environ['IDLEBAZAAR_GAME_ID']}"

Testar pelo navegador

Preencha a chave, o id do jogo e o jogador e envie. A chave e o jogo valem para os dois consoles desta página.

Experimente no sandboxGET /player-votes

Parâmetro / valorPara que serveTipo

X-Api-KeyAutentica a requisição em nome do jogo. Gere a chave em Meus jogos → Integração (abre em nova aba) e cole aqui. Ela é enviada no cabeçalho.Tipo: stringTexto · obrigatórioGAME_IDIdentifica o jogo cujos votos serão consultados ou resgatados. Esse ID faz parte do caminho da URL.Tipo: stringUUID · obrigatórioplayerIdentifica o jogador que recebeu os votos. Use o mesmo identificador informado ao votar. Enviado como parâmetro de consulta na URL.Tipo: stringAté 100 caracteres · obrigatório

curl "https://sandbox.api.idlebazaar.com/v1/public/games/GAME_ID/player-votes?player=PLAYER_ID" \
  -H "X-Api-Key: SUA_CHAVE"

A requisição é enviada ao sandbox sandbox.api.idlebazaar.com. A chave não é guardada.

Experimente no sandboxPOST /player-votes/claim

Parâmetro / valorPara que serveTipo

X-Api-KeyAutentica a requisição em nome do jogo. Gere a chave em Meus jogos → Integração (abre em nova aba) e cole aqui. Ela é enviada no cabeçalho.Tipo: stringTexto · obrigatórioGAME_IDIdentifica o jogo cujos votos serão consultados ou resgatados. Esse ID faz parte do caminho da URL.Tipo: stringUUID · obrigatórioplayerIdentifica o jogador que recebeu os votos. Use o mesmo identificador informado ao votar. Enviado no corpo JSON da requisição.Tipo: stringAté 100 caracteres · obrigatório

curl -X POST "https://sandbox.api.idlebazaar.com/v1/public/games/GAME_ID/player-votes/claim" \
  -H "X-Api-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"player":"PLAYER_ID"}'

A requisição é enviada ao sandbox sandbox.api.idlebazaar.com. A chave não é guardada.

Testando o resgate de votos pelo terminal

1. Gere a chave na página de integração do jogo, em produção, ou use a que você já tem.
2. Faça a chamada de resgate apontando para o sandbox:

curl -X POST "https://sandbox.api.idlebazaar.com/v1/public/games/GAME_ID/player-votes/claim" \
  -H "X-Api-Key: ibv_…" \
  -H "Content-Type: application/json" \
  -d '{ "player": "PLAYER_ID" }'

Como os votos resgatados no sandbox voltam a ficar pendentes na cópia da madrugada, dá para repetir o mesmo teste no dia seguinte.

Atenção

Os dados do sandbox são uma cópia da produção. Não use o sandbox para guardar nada que precise durar.