Skip to content
PuzzleGenio - Strumenti Gratuiti per Creare Puzzle
PuzzleGenio

Riferimento dell’API REST per rompicapi

Usa una chiave API Bearer. La creazione salva il risultato completo in I miei rompicapi e restituisce pagine del browser, non dati di file.

Chiavi API

Autenticazione

Invia Authorization: Bearer YOUR_API_KEY. Gli endpoint esterni non accettano cookie. Conserva la chiave sul tuo server.

Limiti e condivisione

Esempio di richiesta

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 } }'

Esempio di risposta riuscita

{
  "data": {
    "savedId": "123456789",
    "shareId": "AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "type": "wordsearch",
    "preset": "word-search-for-kids",
    "viewUrl": "https://puzzlegenio.com/puzzles/AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "exportPageUrl": "https://puzzlegenio.com/puzzles/AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "editUrl": "https://puzzlegenio.com/word-search-for-kids?id=123456789",
    "playUrl": "https://puzzlegenio.com/word-search-maker/play/AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "expiresAt": "2026-11-01T00:00:00.000Z",
    "shareState": "active",
    "savedCount": 1,
    "limit": 20,
    "formats": [
      "pdf",
      "answer-pdf"
    ],
    "itemCount": 1,
    "warnings": []
  },
  "requestId": "00000000-0000-4000-8000-000000000000"
}

Identificativi e date mostrano solo la struttura. data contiene il risultato salvato; requestId identifica la richiesta.

viewUrl
Pagina pubblica di anteprima; chi ha il link può vedere anche le soluzioni.
exportPageUrl
Pagina del browser in cui scegliere il formato di download. Può coincidere con viewUrl e non è un file diretto.
editUrl
Pagina di modifica riservata al proprietario; richiede accesso e verifica della proprietà.
playUrl
Pagina di gioco solo per le modalità compatibili; altrimenti null.

Endpoint REST

POST/api/v1/puzzles
GET/api/v1/puzzles
GET/api/v1/puzzles/{savedId}
DELETE/api/v1/puzzles/{savedId}
POST/api/v1/puzzles/{savedId}/share
GET/api/v1/capabilities
GET/api/v1/results/{shareId}
POST/api/v1/assets
POST/api/v1/assets/import
GET/api/v1/openapi.json

Schema OpenAPI leggibile dai programmi

Idempotenza e risposte

Idempotency-Key è obbligatorio per creare. Ripetere la stessa chiave con lo stesso contenuto restituisce lo stesso elemento salvato. Un contenuto diverso con la stessa chiave restituisce 409. La prima creazione restituisce 201; la ripetizione 200.

Errori

Gli errori hanno forma {error:{code,message,details},requestId}. 400 indica richiesta errata; 401 autenticazione; 403 quota o permessi; 404 elemento sconosciuto o altrui; 409 conflitto; 410 condivisione inattiva; 413 dimensione eccessiva; 415 tipo di contenuto; 422 parametri o generazione; 429 frequenza con Retry-After; 503 creazione non disponibile.

Riferimento dell’API REST per rompicapi