An original block-building sandbox inspired by voxel games. Practice world seeds, coordinate resources, inventory conflicts and optimistic concurrency.
The Voxel Worlds API models block worlds with players, inventories and integer coordinates. Coordinates are bounded, so it is a compact place to practise boundary testing — the off-by-one at the edge of a valid range, which is the class of bug that unit tests catch and integration tests usually do not.
Base URL: https://funapi.dev/api/voxel/v1 · 6 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.
GET https://funapi.dev/api/voxel/v1/worlds — List worlds. No token, no signup:
curl -i https://funapi.dev/api/voxel/v1/worlds
answers 200 OK with:
{
"total": 1,
"data": [
{
"id": 1,
"name": "Blockshire",
"seed": 424242,
"biome": "meadow",
"difficulty": "normal",
"_v": 1
}
]
}
procedural block worlds
GET /voxel/v1/worlds — List worlds · Responds with 200 Link to this endpointGET /voxel/v1/worlds/{id} — Get a world · Responds with 200 404 Link to this endpointPOST /voxel/v1/worlds — Generate a world from a seed (requires Bearer auth) · Responds with 201 400 401 Link to this endpointGET /voxel/v1/worlds/{id}/blocks/{x}/{y}/{z} — Inspect a block at coordinates · Responds with 200 404 Link to this endpointsurvival stats and inventory
GET /voxel/v1/players — List players · Responds with 200 Link to this endpointPOST /voxel/v1/players/{id}/inventory — Add an inventory item (409 on duplicate) (requires Bearer auth) · Responds with 200 404 409 Link to this endpointLast updated