Skip to content

Sopas de letras Referencia de la API

Sopas de letras: Esta referencia toma modalidades, configuraciones, formatos y campos del mismo registro y contrato que la API.

Ejemplo de solicitud

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": "wordsearch", "preset": "word-search-for-kids", "title": "Animal word search", "input": { "words": [ "CAT", "DOG", "LION", "TIGER" ] }, "options": { "gridSize": 10, "allowDiagonal": false } }'

Modalidades

normal

Configuraciones de página

Formatos de descarga en el navegador

pdf · answer-pdf

Los formatos dependen de la configuración y del plan. viewUrl y exportPageUrl llevan a la descarga en el navegador; la respuesta no incluye datos PDF, PNG ni STL. Los permisos se fijan al publicar y se vuelven a comprobar al republicar.

Campos comunes

CampoValor admitidoObligatorio
presettextoNo
modetextoNo
localeuna opción; en | zh | es | de | fr | pt | it | id | ja | koNo
contentLanguageuna opción; en | zh | es | de | fr | pt | it | id | ja | koNo
titletextoSí
retentionDaysnúmero; enteroNo
appearance.fontFamilyuna opción; sans | serif | handwriting | playful | monoNo
appearance.themeColortextoNo
appearance.footerTexttexto; máximo 200No
appearance.borderStyleuna opción; solid | dashed | dottedNo
appearance.layoutModeuna opción; default | worksheetNo
appearance.pillTitleverdadero/falsoNo
appearance.showWorksheetHeaderverdadero/falsoNo
appearance.outerBorderverdadero/falsoNo
appearance.wordListPositionuna opción; bottom | rightNo
appearance.showGridLinesverdadero/falsoNo
appearance.showDirectionIconsverdadero/falsoNo
appearance.answerStyleuna opción; highlight | circle | strikethroughNo
appearance.titleScalenúmero; mínimo 0.5; máximo 3No
appearance.letterCaseuna opción; uppercase | lowercaseNo
export.paperSizeuna opción; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | customNo
export.widthMmnúmero; mínimo 50; máximo 2000No
export.heightMmnúmero; mínimo 50; máximo 2000No
export.unituna opción; mm | cm | in | pxNo
export.qualityuna opción; standard | high | printNo
input.wordslista; mínimo 1; máximo 200No
input.words[]texto; mínimo 2; máximo 30No
input.templateIdtexto; mínimo 1; máximo 100No
options.seednúmero; entero; mínimo 0; máximo 2147483647No
options.gridSizenúmero; entero; mínimo 5; máximo 30No
options.allowDiagonalverdadero/falsoNo
options.allowBackwardverdadero/falsoNo
options.fillLettersOnlyverdadero/falsoNo

Plantillas y temas

Consulta /api/v1/capabilities para conocer las plantillas, los temas y los límites de tu cuenta. Una plantilla creada también ocupa una plaza de guardado.

Imágenes y archivos

La imagen se indica mediante un assetId subido o importado por la misma cuenta. La descarga se realiza en la página del resultado; su enlace no es un archivo directo.

Casos de error

Los campos desconocidos y las combinaciones incompatibles de type, mode y preset devuelven 422. También devuelve 422 una entrada que no permita completar el pasatiempo. Los formatos dependen de la configuración y del plan.

Sopas de letras Referencia de la API