Rompecabezas Referencia de la API

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

Claves 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": "jigsaw", "title": "Mountain puzzle", "options": { "tilesX": 5, "tilesY": 5, "shape": "rectangle" } }'

Modalidades

normal

Configuraciones de página

Formatos de descarga en el navegador

svg · pdf · png · dxf · zip · stl

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

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.lineColor	texto	No
appearance.lineWidth	número; mínimo 0; máximo 20	No
appearance.strokeOutline	verdadero/falso	No
appearance.outlineColor	texto	No
appearance.outlineWidth	número; mínimo 0; máximo 10	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
export.thicknessMm	número; mínimo 1; máximo 10	No
export.gapMm	número; mínimo 0.1; máximo 1	No
input.imageAssetId	texto	No
options.seed	número; entero; mínimo 0; máximo 2147483647	No
options.tilesX	número; entero; mínimo 1; máximo 100	No
options.tilesY	número; entero; mínimo 1; máximo 100	No
options.sizeX	número; mínimo 1; máximo 10000	No
options.sizeY	número; mínimo 1; máximo 10000	No
options.tabSize	número; mínimo 10; máximo 35	No
options.jitter	número; mínimo 0; máximo 10	No
options.cornerRadius	número; mínimo 0; máximo 100	No
options.shape	texto; mínimo 1; máximo 50	No
options.hexRings	número; entero; mínimo 1; máximo 20	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.