API CapaMatch pour planification et ERP

Comment connecter un système de planification

Créez chaque machine une fois et indiquez dans external_id l’identifiant de votre système. Ensuite, votre système ne transmet plus que la période libre : de quand à quand, et combien d’heures par semaine. Une annonce terminée redevient visible dès qu’elle reçoit une nouvelle période.

Authentification

Créez une clé d’accès dans votre compte et envoyez-la à chaque appel dans l’en-tête Authorization. Tous les appels passent par HTTPS et renvoient du JSON.

Authorization: Bearer cm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Appels

`GET`	`https://capamatch.com/api/v1/machines`	Lire toutes vos machines
`POST`	`https://capamatch.com/api/v1/machines`	Créer une machine ; avec un external_id connu, l’annonce est mise à jour
`GET`	`https://capamatch.com/api/v1/machines/{id}`	Lire une machine
`PATCH`	`https://capamatch.com/api/v1/machines/{id}`	Modifier certains champs
`PUT`	`https://capamatch.com/api/v1/machines/{id}/availability`	Définir uniquement la période libre
`DELETE`	`https://capamatch.com/api/v1/machines/{id}`	Terminer l’annonce

À la place du numéro, vous pouvez utiliser ext: suivi de votre propre identifiant, par exemple /machines/ext:TOUR-07.

Champs

Champ	Type	Obligatoire	Remarque
`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 – obligatoire pour laser, punching, bending, waterjet, welding
`press_force`	number	(✓)	t – obligatoire pour deepdraw
`clamping_force`	number	(✓)	t – obligatoire pour injection
`draw_depth`	number	(✓)	mm – obligatoire pour thermoform
`build_height`	number	(✓)	mm – obligatoire pour 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

Exemples

Créer une machine

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"
  }'

Mettre à jour la période

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}'

Limites

120 appels par minute et 300 machines actives par compte. La période libre peut se terminer au plus tard dans un an.

Sans programmation

Les ateliers sans interface importent leurs machines dans leur compte sous forme de fichier Excel ou CSV.

Description OpenAPI (JSON)

API CapaMatch