Quebra-cabeças Referência da API

Quebra-cabeças: Esta referência obtém modos, configurações, formatos e campos do mesmo registro e contrato da API.

Exemplo de solicitação

curl -X POST https://puzzlegenio.com/api/v1/puzzles \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: task-000000000001' \
  -H 'Content-Type: application/json' \
  -d '{ "type": "jigsaw", "title": "Mountain puzzle", "options": { "tilesX": 5, "tilesY": 5, "shape": "rectangle" } }'

Modos

normal

Configurações de página

Formatos de exportação no navegador

svg · pdf · png · dxf · zip · stl

Os formatos dependem das configurações e do plano. viewUrl e exportPageUrl levam ao download no navegador; a resposta não contém arquivos PDF, PNG ou STL. As permissões são fixadas na publicação e revistas ao republicar.

Campos comuns

Campo	Valor aceito	Obrigatório
preset	texto	Não
mode	texto	Não
locale	uma opção; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	Não
contentLanguage	uma opção; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	Não
title	texto	Sim
retentionDays	número; inteiro	Não
appearance.lineColor	texto	Não
appearance.lineWidth	número; mínimo 0; máximo 20	Não
appearance.strokeOutline	verdadeiro/falso	Não
appearance.outlineColor	texto	Não
appearance.outlineWidth	número; mínimo 0; máximo 10	Não
export.paperSize	uma opção; A3 \| A4 \| A4-landscape \| A5 \| B5 \| Letter \| Letter-landscape \| Legal \| Half-Letter \| Tabloid \| custom	Não
export.widthMm	número; mínimo 50; máximo 2000	Não
export.heightMm	número; mínimo 50; máximo 2000	Não
export.unit	uma opção; mm \| cm \| in \| px	Não
export.quality	uma opção; standard \| high \| print	Não
export.thicknessMm	número; mínimo 1; máximo 10	Não
export.gapMm	número; mínimo 0.1; máximo 1	Não
input.imageAssetId	texto	Não
options.seed	número; inteiro; mínimo 0; máximo 2147483647	Não
options.tilesX	número; inteiro; mínimo 1; máximo 100	Não
options.tilesY	número; inteiro; mínimo 1; máximo 100	Não
options.sizeX	número; mínimo 1; máximo 10000	Não
options.sizeY	número; mínimo 1; máximo 10000	Não
options.tabSize	número; mínimo 10; máximo 35	Não
options.jitter	número; mínimo 0; máximo 10	Não
options.cornerRadius	número; mínimo 0; máximo 100	Não
options.shape	texto; mínimo 1; máximo 50	Não
options.hexRings	número; inteiro; mínimo 1; máximo 20	Não

Modelos e temas

Consulte /api/v1/capabilities para ver modelos, temas e limites da conta. Usar um modelo também ocupa uma vaga salva.

Imagens e arquivos

A entrada de imagem usa um assetId enviado ou importado pela mesma conta. O download acontece na página do resultado; o endereço dessa página não é um arquivo direto.

Casos de erro

Campos desconhecidos ou combinações incompatíveis de type, mode e preset retornam 422. Entradas que não geram um quebra-cabeça completo também retornam 422. Os formatos dependem das configurações e do plano.