# Para desenvolvedores e agentes

> Uma interface reproduzível que funciona no seu dispositivo. Os geradores visíveis usam o mesmo código.

[JSON Schema · v1](https://paperoom.yunusemrevurgun.com/api/schema.json) · [JSON examples](https://paperoom.yunusemrevurgun.com/api/examples.json) · [JSON result](https://paperoom.yunusemrevurgun.com/api/sample-word-search.json) · [ES module](https://paperoom.yunusemrevurgun.com/assets/api.mjs)

## Como usar

Importe o módulo ES público no navegador ou baixe api.mjs, generators.mjs e locales.mjs juntos para um ambiente JavaScript com Intl.Segmenter. Não é preciso chave, conta, IA paga nem requisição ao servidor para gerar jogos.

```js
import {generate} from '/assets/api.mjs';
const result = generate({
  tool: 'word-search', language: 'en', seed: 'garden-42',
  settings: {text: 'GARDEN\nFLOWER\nTREE', size: 12,
    difficulty: 'easy', includeKey: true}
});
console.log(result.pack.grid, result.pack.placements);
```

## Entradas e saída

tool: bingo, tombala, word-search ou cards. language: en, es, ar, pt, zh ou fr. seed: 1 a 64 caracteres. settings: ajustes opcionais; consulte o esquema e os exemplos. Números podem ser números JSON; booleanos devem ser true/false. Os padrões são traduzidos. A saída inclui ajustes, identificador e pack: cards/caller ou grid/placements/words. r e c começam em zero; dr e dc são passos de linha e coluna. GameError expõe code e data. Entradas inválidas falham sem descartar palavras.

## Reprodução e links estáveis

O mesmo código v1, semente, idioma e ajustes produzem a mesma saída. Guarde a versão e as entradas; versões futuras podem mudar. Os links aceitam seed e controles simples. Palavras personalizadas não precisam estar na URL. Use arquivos JSON para conteúdo próprio. Os limites são os mesmos do formulário.

[BINGO · seed=paperoom-demo](https://paperoom.yunusemrevurgun.com/pt/bingo/?mode=75&count=8&seed=paperoom-demo)

## Exportação local de PDF

No navegador, importe createPDF de /assets/pdf.mjs e locales de /assets/locales.mjs. Passe {pack:result.pack, current:{...result.settings,id:result.id}, tool:result.tool,t:locales[result.language]} e chame doc.save("games.pdf"). Código e fontes são carregados deste site sob demanda. Nenhum conteúdo do jogo é enviado. A impressão e o PDF apresentam os mesmos dados.

## Todos os jogos para imprimir

A mesma chamada generate() cobre todos os jogos do site. Leia tools para a lista, fields(tool) para as configurações de um jogo e text(tool, language) para seus rótulos. Para todos os jogos, exceto os quatro geradores originais, layout(result) devolve páginas vetoriais em milímetros, e toSVG(page) desenha uma delas em SVG.

Um catálogo legível por máquinas de todos os jogos, com suas categorias, regiões e páginas em seis idiomas, está em /api/games.json. Os guias em texto simples para modelos de linguagem estão em /llms.txt e /llms-full.txt, e cada página traz, no cabeçalho, um link para a versão em Markdown (index.md).

`tool`: `bingo`, `tombala`, `word-search`, `cards`, `alquerque`, `battleship`, `bulls-and-cows`, `checkers`, `crossword`, `dice-scores`, `dominoes`, `dots-and-boxes`, `exquisite-corpse`, `fortune-teller`, `gomoku`, `goose`, `hangman`, `hex`, `letter-grid`, `loteria`, `ludo`, `mancala`, `maze`, `memory`, `nine-mens-morris`, `nonogram`, `paper-dice`, `paper-soccer`, `raffle-tickets`, `royal-ur`, `scavenger-hunt`, `score-sheets`, `secret-code`, `snakes-and-ladders`, `stop`, `sudoku`, `telephone`, `tic-tac-toe`, `word-scramble`, `xiangqi`

```js
import {generate,layout,toSVG} from 'https://paperoom.yunusemrevurgun.com/assets/api.mjs';
const result=generate({tool:'sudoku',language:'pt',seed:'demo',settings:{size:9,difficulty:'easy'}});
const svg=layout(result).map(toSVG); // vector pages, millimetres
```

---
Languages: [English](https://paperoom.yunusemrevurgun.com/developers/index.md) · [Español](https://paperoom.yunusemrevurgun.com/es/developers/index.md) · [العربية](https://paperoom.yunusemrevurgun.com/ar/developers/index.md) · [Português](https://paperoom.yunusemrevurgun.com/pt/developers/index.md) · [中文](https://paperoom.yunusemrevurgun.com/zh/developers/index.md) · [Français](https://paperoom.yunusemrevurgun.com/fr/developers/index.md)
Page: https://paperoom.yunusemrevurgun.com/pt/developers/ · Paperoom by Yunus Emre Vurgun · https://paperoom.yunusemrevurgun.com/llms.txt