Sudokumax Puzzle API
Generate verified Sudoku worksheets, downloadable PDFs and stable playable links and short hosted collection links. Free with mandatory attribution. API key…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Generate verified Sudoku worksheets, downloadable PDFs and stable playable links and short hosted collection links. Free with mandatory attribution. API key required. Online outputs must visibly hyperlink to https://sudokumax.com; offline outputs must print sudokumax.com. Maximum 20 puzzles per batch and 16 KiB request bodies. 6000 authenticated requests per account per minute, with additional per-instance limits. PDF download links expire after 24 hours and are disabled when their key or account is revoked. Difficulty is verified with a deterministic technique ladder: beginner=naked singles, easy=hidden singles, medium=locked candidates, hard=naked pairs, expert=requires techniques beyond that ladder. Expert does not identify a specific advanced technique. Batch grids are non-equivalent under standard Sudoku symmetries. Developer accounts manage access; published puzzle links are public. The daily JavaScript widget does not consume the API quota.
Endpoints 13
- POSTGenerate verified puzzles
/generate - POSTCheck uniqueness
/check - POSTAnalyze solving techniques
/analyze - POSTValidate a player board
/validate - POSTGet an explained Sudoku hint
/hint - POSTCreate playable and collection links
/publish - POSTExport supplied puzzles to PDF
/worksheets - POSTGenerate a complete worksheet pack
/packs - POSTList private puzzle metadata in this key’s personal or team library. Requires library:read. Paginated; does not publish anything.
/library/list - POSTRead a saved private puzzle and its answer by ID. Requires library:read. Keep the answer server-side.
/library/get - POSTSave a verified puzzle privately with a name and tags. Requires library:write. To update, supply both id and current revision. No public link is created.
/library/save - POSTDelete a saved private puzzle by ID and current revision. Requires library:write. This permanently deletes the entry.
/library/delete - GETDownload a worksheet PDF
/worksheets/:id
API details
- Base URL
https://sudokumax.com/api/v1- Authentication
- A bearer token in the Authorization header
An API key in the download query parameter - Operations
- 13 operations on 13 pathsPOST 12GET 1
- Response formats
application/jsonapplication/pdf- Description format
- OpenAPI 3.1.0, API version
1.2.0 - Links
- OpenAPI document · Support
- Listed from
- Sudokumax's published OpenAPI description
How to test the Sudokumax Puzzle API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Sudokumax Puzzle API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Generate verified puzzles” (POST /generate), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Sudokumax Puzzle API?
Generate verified Sudoku worksheets, downloadable PDFs and stable playable links and short hosted collection links. Free with mandatory attribution. API key… It is listed under Media & content and has 13 endpoints.
Who publishes the Sudokumax Puzzle API?
It is listed from Sudokumax's public API description (an OpenAPI document), not published by Sudokumax on Swastik Codes. Anyone who controls sudokumax.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Sudokumax Puzzle API?
Requests go to https://sudokumax.com/api/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Sudokumax Puzzle API?
It accepts 2 methods: A bearer token in the Authorization header; an API key in the download query parameter.
How many endpoints does the Sudokumax Puzzle API have?
13 operations on 13 paths (12 POST, 1 GET).
Is forking the Sudokumax Puzzle API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.