Clueforge

Builds a crossword puzzle with a hidden solution word from clue/answer pairs you write, and returns a text preview plus a clue-forge.com link where the user can view, edit and download it as a print-ready PDF/HTML. Use it for personalised puzzles (birthday, wedding, couples, Valentine's Day, Christmas, classroom, team events) or general-knowledge puzzles. Rules: answers are single words, 2–15 letters, no spaces; each letter of solution_word must occur in a different answer (add clues if a letter is missing); the answer must not appear in its clue; do not use the solution word itself as an answer. Write clues in the language given by "language". Always show the returned link to the user.

{
  "type": "object",
  "properties": {
    "solution_word": {
      "type": "string",
      "description": "Hidden word revealed by the highlighted letters, e.g. a name like \"ANNA\" or \"LOVE\". 2–20 letters."
    },
    "clues": {
      "type": "array",
      "minItems": 5,
      "maxItems": 40,
      "description": "Clue/answer pairs. Use at least as many pairs as the solution word has letters; 8–14 works best.",
      "items": {
        "type": "object",
        "properties": {
          "clue": {
            "type": "string",
            "description": "The question shown to the solver."
          },
          "answer": {
            "type": "string",
            "description": "Single-word answer. Accents and umlauts are converted automatically."
          }
        },
        "required": [
          "clue",
          "answer"
        ]
      }
    },
    "occasion": {
      "type": "string",
      "enum": [
        "couple",
        "wedding",
        "birthday",
        "valentines",
        "christmas",
        "general"
      ],
      "description": "Selects the matching theme in the editor. Defaults to \"general\"."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "de",
        "fr",
        "es",
        "it",
        "pt",
        "nl",
        "pl"
      ],
      "description": "Language of the clues and of the Clueforge interface. Defaults to \"en\"."
    }
  },
  "required": [
    "solution_word",
    "clues"
  ]
}

{
  "type": "object",
  "properties": {
    "link": {
      "type": "string"
    },
    "solution_word": {
      "type": "string"
    },
    "placed_words": {
      "type": "integer"
    },
    "unplaced_words": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "grid": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "link",
    "solution_word",
    "placed_words",
    "unplaced_words",
    "grid"
  ]
}