CapaMatch-API für Planungs- und ERP-Systeme

So bindest du ein Planungssystem an

Lege jede Maschine einmal an und gib ihr in external_id die Kennung aus deinem System. Danach überträgt dein System nur noch das freie Zeitfenster: von wann bis wann und wie viele Stunden pro Woche. Ein beendeter Eintrag wird durch ein neues Zeitfenster wieder sichtbar.

Anmeldung

Erzeuge in deinem Konto einen Zugangsschlüssel und sende ihn bei jedem Aufruf im Kopf Authorization. Alle Aufrufe laufen über HTTPS und liefern JSON.

Authorization: Bearer cm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Aufrufe

`GET`	`https://capamatch.com/api/v1/machines`	Alle eigenen Maschinen lesen
`POST`	`https://capamatch.com/api/v1/machines`	Maschine anlegen; bei bekannter external_id wird der Eintrag aktualisiert
`GET`	`https://capamatch.com/api/v1/machines/{id}`	Eine Maschine lesen
`PATCH`	`https://capamatch.com/api/v1/machines/{id}`	Einzelne Felder ändern
`PUT`	`https://capamatch.com/api/v1/machines/{id}/availability`	Nur das freie Zeitfenster setzen
`DELETE`	`https://capamatch.com/api/v1/machines/{id}`	Eintrag beenden

Statt der Nummer kannst du ext: gefolgt von deiner eigenen Kennung verwenden, zum Beispiel /machines/ext:DREH-07.

Felder

Feld	Typ	Pflicht	Hinweis
`external_id`	string		≤ 80
`process`	string	✓	turning, swiss, milling, milling5, grinding, edm, laser, punching, bending, deepdraw, waterjet, welding, injection, thermoform, printing3d
`brand`	string	✓	≤ 60
`model`	string	✓	≤ 60
`year`	integer		1950–2027
`diameter_min, diameter_max`	number	✓	mm
`length_min, length_max`	number	✓	mm
`tolerance_min, tolerance_max`	number	✓	± mm
`thickness_max`	number	(✓)	mm – Pflicht bei laser, punching, bending, waterjet, welding
`press_force`	number	(✓)	t – Pflicht bei deepdraw
`clamping_force`	number	(✓)	t – Pflicht bei injection
`draw_depth`	number	(✓)	mm – Pflicht bei thermoform
`build_height`	number	(✓)	mm – Pflicht bei printing3d
`materials`	array		steel, stainless, aluminium, titanium, brass, copper, nickel, plastics, abs, pa, pc, pp, pe, pom, peek, ps, pet
`part_types`	array		≤ 12 × 40
`certificates`	array		ISO 9001, EN 9100, IATF 16949, ISO 13485
`description`	string		≤ 800
`free_from, free_to`	date	✓	YYYY-MM-DD
`hours_per_week`	integer		1–168
`country`	string	✓	ISO 3166-1 alpha-2: AT, BE, BG, BR, CA, CH, CN, CZ, DE, DK, ES, FI, FR, GB, HR, HU, IE, IN, IT, JP, KR, MX, NL, NO, PL, PT, RO, RS, SE, SI, SK, TH, TR, TW, US, VN
`region`	string	✓	≤ 80
`company`	string	✓	≤ 120

Beispiele

Maschine anlegen

curl -X POST https://capamatch.com/api/v1/machines \
  -H "Authorization: Bearer $CAPAMATCH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "LATHE-07",
    "process": "turning",
    "brand": "Index",
    "model": "G200",
    "diameter_min": 5, "diameter_max": 65,
    "length_min": 10, "length_max": 400,
    "tolerance_min": 0.005, "tolerance_max": 0.05,
    "materials": ["steel", "stainless"],
    "certificates": ["ISO 9001"],
    "free_from": "2026-10-07", "free_to": "2026-10-28",
    "hours_per_week": 40,
    "country": "DE", "region": "Stuttgart",
    "company": "Example GmbH"
  }'

Zeitfenster aktualisieren

curl -X PUT https://capamatch.com/api/v1/machines/ext:LATHE-07/availability \
  -H "Authorization: Bearer $CAPAMATCH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"free_from": "2026-10-07", "free_to": "2026-10-28", "hours_per_week": 60}'

Grenzen

120 Aufrufe pro Minute und 300 aktive Maschinen je Konto. Das freie Zeitfenster darf höchstens ein Jahr in der Zukunft enden.

Ohne Programmierung

Betriebe ohne Schnittstelle laden ihre Maschinen im Konto als Excel- oder CSV-Datei hoch.

OpenAPI-Beschreibung (JSON)

CapaMatch-API