An original block-building sandbox inspired by voxel games. Practice world seeds, coordinate resources, inventory conflicts and optimistic concurrency.
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.
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 endpointThe 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.
GET https://funapi.dev/api/voxel/v1/worlds — List worlds. No token, no signup:
curl -i https://funapi.dev/api/voxel/v1/worlds
Response: 200 OK
{
"total": 1,
"data": [
{
"id": 1,
"name": "Blockshire",
"seed": 424242,
"biome": "meadow",
"difficulty": "normal",
"_v": 1
}
]
}
Last updated