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
Campos comunes
| Campo | Valor admitido | Obligatorio |
|---|---|---|
| preset | texto | No |
| mode | texto | No |
| locale | una opción; en | zh | es | de | fr | pt | it | id | ja | ko | No |
| contentLanguage | una opción; en | zh | es | de | fr | pt | it | id | ja | ko | No |
| title | texto | Sí |
| retentionDays | número; entero | No |
| appearance.fontFamily | una opción; sans | serif | handwriting | playful | mono | No |
| appearance.themeColor | texto | No |
| appearance.footerText | texto; máximo 200 | No |
| appearance.borderStyle | una opción; solid | dashed | dotted | No |
| appearance.layoutMode | una opción; default | worksheet | No |
| appearance.pillTitle | verdadero/falso | No |
| appearance.showWorksheetHeader | verdadero/falso | No |
| appearance.outerBorder | verdadero/falso | No |
| appearance.wordListPosition | una opción; bottom | right | No |
| appearance.showGridLines | verdadero/falso | No |
| appearance.showDirectionIcons | verdadero/falso | No |
| appearance.answerStyle | una opción; highlight | circle | strikethrough | No |
| appearance.titleScale | número; mínimo 0.5; máximo 3 | No |
| appearance.letterCase | una opción; uppercase | lowercase | No |
| export.paperSize | una opción; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | custom | No |
| export.widthMm | número; mínimo 50; máximo 2000 | No |
| export.heightMm | número; mínimo 50; máximo 2000 | No |
| export.unit | una opción; mm | cm | in | px | No |
| export.quality | una opción; standard | high | print | No |
| input.words | lista; mínimo 1; máximo 200 | No |
| input.words[] | texto; mínimo 2; máximo 30 | No |
| input.templateId | texto; mínimo 1; máximo 100 | No |
| options.seed | número; entero; mínimo 0; máximo 2147483647 | No |
| options.gridSize | número; entero; mínimo 5; máximo 30 | No |
| options.allowDiagonal | verdadero/falso | No |
| options.allowBackward | verdadero/falso | No |
| options.fillLettersOnly | verdadero/falso | No |
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.
