Gerenciar modelos de impressora

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo printer-models:write e a permissão correspondente em Modelos.
Cadastrar é idempotente (envie um Idempotency-Key).
Não pode existir outro modelo ativo com o mesmo tipo de equipamento, marca, submarca e nome: a API recusa com 422. Busque antes com GET /printer-models?search=.
A marca vem de GET /brands, o tipo de equipamento de GET /equipment-types e a submarca do sub_brand de um modelo já cadastrado.
A edição (PATCH) é parcial; desativar (DELETE) não apaga e a compatibilidade dos produtos continua gravada. Reativar é pelo painel.
Equivalentes, apelidos, características e foto do modelo ficam no painel.

Referência

POST /printer-models na Referência da API PATCH /printer-models/{printerModel} DELETE /printer-models/{printerModel}

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/printer-models" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "WF-C5890",
    "brand_id": 1,
    "sub_brand_id": 7,
    "type_equipment_id": 3,
    "maintenance": true
}'

Resposta

Resposta · 201

{
  "data": {
    "id": 315,
    "name": "WF-C5890",
    "partnumber": null,
    "type_equipment_id": 3,
    "type_equipment": "Impressora",
    "maintenance": true,
    "is_generic": false,
    "capabilities": { "ink_levels": "untested", "nozzle_check": "untested", "head_clean": "untested", "waste_reset": "untested" },
    "status": true,
    "brand": { "id": 1, "name": "Epson" },
    "sub_brand": { "id": 7, "name": "WorkForce" }
  }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.