API de CapaMatch para planificación y ERP

Cómo conectar un sistema de planificación

Crea cada máquina una vez e indica en external_id el identificador de tu sistema. Después tu sistema solo envía el periodo libre: desde cuándo, hasta cuándo y cuántas horas por semana. Un anuncio finalizado vuelve a ser visible cuando recibe un periodo nuevo.

Autenticación

Crea una clave de acceso en tu cuenta y envíala en cada llamada en la cabecera Authorization. Todas las llamadas usan HTTPS y devuelven JSON.

Authorization: Bearer cm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Llamadas

`GET`	`https://capamatch.com/api/v1/machines`	Leer todas tus máquinas
`POST`	`https://capamatch.com/api/v1/machines`	Crear una máquina; con un external_id conocido se actualiza el anuncio
`GET`	`https://capamatch.com/api/v1/machines/{id}`	Leer una máquina
`PATCH`	`https://capamatch.com/api/v1/machines/{id}`	Cambiar campos concretos
`PUT`	`https://capamatch.com/api/v1/machines/{id}/availability`	Fijar solo el periodo libre
`DELETE`	`https://capamatch.com/api/v1/machines/{id}`	Finalizar el anuncio

En lugar del número puedes usar ext: seguido de tu propio identificador, por ejemplo /machines/ext:TORNO-07.

Campos

Campo	Tipo	Obligatorio	Nota
`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 – obligatorio para laser, punching, bending, waterjet, welding
`press_force`	number	(✓)	t – obligatorio para deepdraw
`clamping_force`	number	(✓)	t – obligatorio para injection
`draw_depth`	number	(✓)	mm – obligatorio para thermoform
`build_height`	number	(✓)	mm – obligatorio para 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

Ejemplos

Crear una máquina

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

Actualizar el periodo

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

Límites

120 llamadas por minuto y 300 máquinas activas por cuenta. El periodo libre puede terminar como máximo dentro de un año.

Sin programar

Los talleres sin interfaz suben sus máquinas en su cuenta como archivo Excel o CSV.

Descripción OpenAPI (JSON)

API de CapaMatch