Entity · tools

Tool Schema

Schema-ID

tool

Collection

tools

Permissions

Lesentool_view
Anlegentool_create
Änderntool_edit
Löschentool_delete

Felder

Tool Schema

tools4 Permissions

Schema for validating tool / Werkzeug entities

namestringerforderlich

Tool name / Bezeichnung

1–200 Zeichen

descriptionstringoptional

Optional description

max 2000 Zeichennullable

typestringerforderlich

TOOL = individual tool, BAG = tool bag containing other tools

Werte

TOOLBAG

categorystringoptional

Tool category

Werte

ElektrowerkzeugHandwerkzeugMesswerkzeugMaschineSonstiges

nullable

manufacturerstringoptional

Manufacturer / Hersteller

max 100 Zeichennullable

modelstringoptional

Model name

max 100 Zeichennullable

serialNumberstringoptional

Serial number / Seriennummer

max 100 Zeichennullable

statusstringerforderlich

IN_STORAGE = im Lager, CHECKED_OUT = mitgenommen

Werte

IN_STORAGECHECKED_OUT

Default: "IN_STORAGE"

checkedOutByuuidoptional

User ID who checked out the tool

nullable

checkedOutAtdatetimeoptional

Timestamp when tool was checked out

nullable

toolBagIduuidoptional

Parent tool bag ID (only for type=TOOL)

nullable

locationstringoptional

Storage location / Lagerort (e.g. Regal A3)

max 200 Zeichennullable

purchaseDatedateoptional

Purchase date

nullable

purchasePricenumberoptional

Purchase price in EUR

≥ 0nullable

notesstringoptional

Free-text notes

max 5000 Zeichennullable

tagsstring[]optional

Tags for categorization

Default: []

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

GET /api/v1/tools — Liste, paginiert + filterbar
GET /api/v1/tools/<id> — Einzelne Entity
POST /api/v1/tools — Anlegen
PATCH /api/v1/tools/<id> — Teil-Update
DELETE /api/v1/tools/<id> — Soft-Delete
GET /api/v1/tools/<id>/timeline — Audit + Aktivitäten