Arkitektonika

The original resource by IntellectualSites can be found here

Arkitektonika is a REST repository for NBT data. It accepts uploads of valid NBT data and stores them in a local folder while accounting for its metadata in a local sqlite database. ~~Optionally, uploaded files can be expired based on the configurable age by running the prune script~~. Files can always be deleted via their deletion key.

To Run

With Docker

git clone https://github.com/TheNextLvl-net/Arkitektonika.git &&
cd Arkitektonika &&
docker compose up

From scratch

git clone https://github.com/TheNextLvl-net/Arkitektonika.git &&
cd Arkitektonika &&
./gradlew shadowJar &&
java -jar $(find build/libs/ -name "*.jar" -print -quit)

Configuration

{
  "port": 3000,
  "prune": 1800000,
  "maxSchematicSize": 1000000,
  "allowedOrigin": "*",
  "limiter": { # not implemented yet
    "windowMs": 60000,
    "delayAfter": 30,
    "delayMs": 500
  }
}

Config Key	Description
port	on which port should the application bind
prune	defines how old records must be to be deleted by the prune script (in ms)
maxSchematicSize	maximum size of schematic files to be accepted (in bytes)
limiter.windowMs	the frame of the limiter (after what duration should the limit gets reset)
limiter.delayAfter	After how many requests during windowMs should delayMs be applied
limiter.delayMs	How many ms should the request take longer. Formula: `currentRequestDelay = (currentRequestAmount - delayAfter) * delayMs`

File structure:

data
├── config.json
├── database.db
└── schemataics
    ├── fe65d7edc37149c47171962dc26a039b
    └── a98f299c5cf294e6555617e83226bcdd

config.json holds the user configuration data
database.db holds the required data for each schematic
schematics holds all schematic file data

Routes

All routes will be available at the exposed port (e.g. localhost:3000).

Upload a file

POST INSTANCE_URL/upload: send your file as multipart/form-data; example:

curl --location --request POST 'http://localhost:3000/upload' \
--form 'schematic=@/path/to/plot.schem'

response:

code	meaning
200	file was of valid NBT format and was accepted
400	file was not of valid NBT format
413	file payload was too large and rejected
500	file could not be found on disk after being uploaded (upload failed)

success body:

{
  "download_key": "db6186c8795740379d26fc61ecba1a24",
  "delete_key": "11561161dffe4a1298992ce063be5ff9"
}

The download key allows you to download the file, and the delete key lets you delete it. Share the download_key, but not the delete_key.

Check download headers

HEAD INSTANCE_URL/download/:download_key: check what headers you'd get if you sent a POST request for a file with the given download_key; example:

curl --location --head 'http://localhost:3000/download/db6186c8795740379d26fc61ecba1a24'

The response for this is in the form of status codes only.

Status-Code	Meaning
200	File was found, prospective download would succeed
404	File was not found in the database
410	File metadata is in accounting table, but file is not on disk or already expired
500	An internal server error occurred due to corrupted metadata (missing data in database)

Download a file

GET INSTANCE_URL/download/:download_key: download a file with the given download_key; example:

curl --location --request GET 'http://localhost:3000/download/db6186c8795740379d26fc61ecba1a24'

response: see Check download headers above.

On success, the file is sent as an attachment for download to the browser / requester.

Check deletion headers

HEAD INSTANCE_URL/delete/:delete_key: check what headers you'd get if you sent a DELETE request for a file with the given delete_key; example:

curl --location --head 'http://localhost:3000/delete/11561161dffe4a1298992ce063be5ff9'

The response for this is in the form of status codes only.

Status-Code	Meaning
200	File was found, prospective deletion would succeed
404	File was not found in the database
410	File metadata is in accounting table, but file is not on disk or already expired
500	An internal server error occurred due to corrupted metadata (missing data in database)

Delete a file

DELETE PUBLIC_URL/delete/:delete_key: delete a file with the given delete_key; example:

curl --location --request DELETE 'http://localhost:3000/delete/11561161dffe4a1298992ce063be5ff9'

response: see Check deletion headers above.

On success, the file is deleted and the record is marked as expired in the database.

TheNextLvl-net / Arkitektonika