---
title: "Playground"
description: "Execute chamadas reais da SDK pelo navegador."
---
O playground monta um formulário a partir do schema da rota. Você preenche os campos, executa e vê a resposta real da API. A barra de endereço mostra a URL completa que será chamada, com domínio, `/v1`, rota e query.

> As chamadas saem do seu navegador e usam a API configurada. Um login bem-sucedido salva o token automaticamente para as próximas execuções.

<div id="sdk-playground">
    <p>Carregando playground...</p>
</div>

<noscript>O playground precisa de JavaScript habilitado.</noscript>

## Como usar

1. Na aba **Requisição**, informe a **Base URL** da API. Pode ser só o domínio: `api.sualoja.com.br`.
2. Escolha o **namespace** e o **método**.
3. Confira a **barra de endereço** com a URL completa.
4. Preencha os campos de **Query** e **Body**. Campos obrigatórios têm `*`.
5. Clique em **Executar chamada**.

A SDK completa HTTPS e `/v1` automaticamente. Se a API estiver em outro domínio, o backend precisa liberar CORS para `cinderace.luckymaker.app`.

## Abas

- **Requisição:** Base URL, namespace, método, barra de endereço, campos, ações e resposta.
- **State:** token salvo, UUID do carrinho e versão da SDK. Os botões de limpar removem o que a SDK reutiliza no `localStorage`.

O UUID do carrinho não é um campo do formulário. A SDK cria e salva esse valor sozinha, e a barra de endereço mostra o UUID atual quando ele existe.

:::note[Body e JSON]
Corpos simples viram formulário. Objetos aninhados viram fieldsets, e unions/arrays complexos usam um editor JSON com realce, números de linha e validação.
:::