Skip to content

API ‐ V1

Chris Mavrommatis edited this page Mar 28, 2025 · 3 revisions

Version 1 of the Binacle.Net API focuses exclusively on the Fitting function, which finds the smallest bin capable of accommodating all provided items.

🔍 Learn more: What the fitting function is

Warning

This API version has been deprecated as of v1.2.0 and will be removed in v2.0.0. Consider migrating to Version 2 for improved functionality.

🔌 Endpoints

📜 Presets

GET /api/v1/presets
📩 Returns a list of predefined bin collections.

💡 Query by Preset

POST /api/v1/query/by-preset/{preset}
📡 Provide a list of items and a preset key.
📩 The API will return the smallest bin from the preset that can fit all items (if possible).

💡 Query by Custom

POST /api/v1/query/by-custom
📡 Provide a list of bins and items.
📩 Returns the smallest bin from the given bins that fits all items.

Clone this wiki locally