{% extends "base.html" %} {% block title %}API-Installation{% endblock %} {% block heading %}API-Installation{% endblock %} {% block content %}

Schritt 1 — API aktivieren & Token erzeugen

Token wird für jede API-Anfrage als Authorization: Bearer … Header benötigt

{% if settings.get('api_token') %}

API ist aktiv ✓

Token unten verwenden. Bei Verlust: neu erzeugen — der alte wird ungültig.

{% else %}

API noch nicht aktiviert

Klicke unten — wir erzeugen einen Token, aktivieren die API und du kannst sofort loslegen.

{% endif %}

Schritt 2 — Test-Aufruf

Kopiere einen der curl-Befehle, ersetze $TOKEN durch deinen Token

curl http://localhost:8001/health
curl -H "Authorization: Bearer $TOKEN" \
  http://localhost:8001/api/items
curl -H "Authorization: Bearer $TOKEN" \
  -X POST -d "delta=-1&action_code=stock_out&user_id=1" \
  http://localhost:8001/items/12/adjust
curl -H "Authorization: Bearer $TOKEN" \
  -X POST -d "ident=BST-TEST&source_app=tools&line_0_item_id=12&line_0_quantity=10" \
  http://localhost:8001/orders/new

Schritt 3 — Endpunkt-Übersicht

Alle Read-Endpoints geben JSON zurück, wenn der Accept: application/json Header gesetzt wird

MethodePfadBeschreibung
GET/healthHealth-Check, ohne Token
GET/api/itemsAlle Artikel mit Bestand & Lagerort
GET/api/items/{id}Einzelner Artikel
POST/items/{id}/rentWerkzeug ausleihen
POST/rentals/{id}/returnRückgabe buchen
POST/items/{id}/adjustBestand manuell buchen
POST/orders/newBestellung anlegen
POST/orders/{id}/receiveWareneingang buchen
POST/items/{id}/inspectPrüfung erfassen (Mess-/Spannmittel)
POST/production/{id}/progressStückzahl von Maschine melden
GET/export/items.csvCSV-Export aller Artikel
GET/orders/{id}/pdfBestellschein-PDF

Schritt 4 — Scanner-App pairen

Mobile Barcode-Scanner mit der API verbinden

Server-URL

http://<deine-IP>:8001

Auf Werkstatt-WLAN: gleiche Subnet wie der Server

Token

{{ settings.get('api_token', '— oben generieren —') }}

Pair-QR (für Scanner-App)

{% if settings.get('api_token') %} API-Token QR {% else %}
QR erscheint nach Token-Generierung
{% endif %}
{% endblock %}