ForHosting KIT · Ferramentas para dev

Gere uma grade de caça-palavras reproduzível

Transforme uma lista em uma grade completa de caça-palavras sem posicionar cada letra manualmente.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe as palavras, o tamanho quadrado e uma semente inteira; o gerador posiciona os termos na horizontal, vertical ou diagonal, permite cruzamentos com letras compatíveis e preenche as células restantes de modo reproduzível. A resposta traz as linhas prontas e as coordenadas exatas, atendendo atividades impressas, testes automatizados, materiais escolares e aplicativos que precisam de um desafio estável acompanhado de um gabarito confiável.

Prepare a lista e escolha as dimensões da grade

Comece com uma a vinte palavras diferentes, escritas com as letras inglesas de A a Z. Maiúsculas e minúsculas não alteram o desafio, pois o gerador converte cada termo aceito para maiúsculas antes do posicionamento. Defina <code>grid_size</code> como a quantidade de linhas e colunas da grade quadrada, entre 2 e 25. A palavra mais longa não pode ultrapassar essa dimensão: um termo de seis letras exige pelo menos seis células, já que cada entrada segue uma linha reta. Uma grade maior cria mais espaço e letras de preenchimento; uma grade compacta costuma favorecer cruzamentos. Se a lista não couber, aumente a dimensão ou remova termos. Duplicatas são rejeitadas depois da normalização para evitar itens ambíguos no gabarito. Espaços, hífens, acentos, algarismos e pontuação também não são aceitos, garantindo um único caractere previsível por célula.

Use uma semente para repetir posições e preenchimento

O campo <code>seed</code> controla todas as escolhas que pareceriam aleatórias. Para cada palavra, o gerador reúne posições válidas para leste, oeste, norte, sul e as quatro diagonais, ordenando-as com uma sequência pseudoaleatória derivada da semente. Ele trata primeiro os termos mais longos e recua de forma determinística quando uma escolha impede a colocação de outro termo. Duas palavras só compartilham uma célula quando precisam da mesma letra, preservando a leitura dos cruzamentos. Depois que toda a lista está posicionada, a mesma sequência cria as letras de preenchimento. Repetir palavras idênticas na mesma ordem, dimensão e semente devolve exatamente a mesma grade e os mesmos posicionamentos. Isso facilita reconstruir materiais e fixtures a partir de uma configuração pequena. A semente oferece reprodutibilidade, mas não sigilo nem aleatoriedade criptográfica.

Leia a grade e monte o gabarito

A resposta apresenta <code>grid</code> como uma lista de strings do mesmo comprimento, uma por linha. Você pode exibi-las com fonte monoespaçada ou separar cada string em caracteres para montar células individuais. As coordenadas em <code>placements</code> começam em zero: <code>row: 0</code> e <code>column: 0</code> indicam o canto superior esquerdo. Os códigos <code>E</code> e <code>W</code> são horizontais, <code>N</code> e <code>S</code> são verticais, e <code>NE</code>, <code>NW</code>, <code>SE</code> e <code>SW</code> são diagonais. Os posicionamentos mantêm a ordem enviada, mesmo que a busca processe palavras maiores primeiro. Você pode ocultar esse conjunto dos jogadores e guardá-lo como gabarito, ou usá-lo para destacar respostas em uma interface. Caso não exista arranjo completo, a chamada retorna erro de entrada em vez de descartar termos ou entregar uma grade parcial.

Casos de uso

Crie atividades escolares

Gere um desafio estável para estudantes e preserve os posicionamentos retornados como gabarito separado.

Desenvolva jogos interativos

Mostre a grade em células selecionáveis e valide cada palavra marcada pelas coordenadas e direções.

Produza fixtures reproduzíveis

Armazene uma lista compacta e uma semente e reconstrua a mesma grade sempre que os testes rodarem.

Perguntas frequentes

Quanto custa uma chamada de API?

O preço da API é US$ 0,002 por caça-palavras; o mesmo gerador também funciona gratuitamente no navegador.

A mesma semente sempre gera o mesmo desafio?

Sim, quando as palavras, sua ordem, a dimensão e a semente permanecem exatamente iguais.

Quais direções podem ser usadas?

Os termos seguem nos dois sentidos horizontal, vertical ou diagonal, totalizando oito códigos.

Duas palavras podem compartilhar letras?

Sim. Elas podem se cruzar quando ambas exigem o mesmo caractere naquela célula.

O que acontece quando a lista não cabe?

O gerador retorna erro de entrada, nunca uma grade parcial; aumente a dimensão ou reduza a lista.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/game/word-search-grid-generate

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/game/word-search-grid-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"words":["ORBIT","MOON","STAR"],"grid_size":8,"seed":42}'

const res = await fetch("https://api.kit.forhosting.com/game/word-search-grid-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "words": [
      "ORBIT",
      "MOON",
      "STAR"
    ],
    "grid_size": 8,
    "seed": 42
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/word-search-grid-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "words": [
        "ORBIT",
        "MOON",
        "STAR"
    ],
    "grid_size": 8,
    "seed": 42
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/word-search-grid-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"words":["ORBIT","MOON","STAR"],"grid_size":8,"seed":42}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"words":["ORBIT","MOON","STAR"],"grid_size":8,"seed":42}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/word-search-grid-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "words": [
    "ORBIT",
    "MOON",
    "STAR"
  ],
  "grid_size": 8,
  "seed": 42
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.word_search_grid_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_grid_size`	25
`max_words`	20

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →