Files

Get printers ranked by compatibility with a file

Changed on

Returns all printers in the organization ranked by their compatibility with the specified model file. Considers printer model, available filament slots, and material matching with color proximity.

get/v1/files/{fileId}/compatible-printers

Request

  • Base URL: https://api.printhiv3d.com
  • URL: https://api.printhiv3d.com/v1/files/{fileId}/compatible-printers
  • Auth: HTTP bearer

Path parameters

fileIdstring uuid required

The model file ID

Query parameters

organizationIdstring uuid

Organization ID (uses default if not provided)

includeOffline'true' | 'false'

Include offline printers in results

makeIdstring uuid

Make ID to use for exact material matching via make_materials

colorThresholdnumber

Delta-E threshold for color proximity matching (0-100)

materialIdsstring

JSON array of {index, materialId} for explicit material requirements

acceptableMaterialsstring

JSON acceptable material sets: an array of {optionId, label?, materialIds:[{index, materialId}]}, or an indexed map of acceptable_materials rules {index: [{material_id|type|colors|color_threshold|profile_id|profile_ids}]}

strategyExactMaterial'true' | 'false'

Enable exact material ID matching strategy

strategyTypeColor'true' | 'false'

Enable type + color matching strategy

strategyLooseMatch'true' | 'false'

Enable loose (type only) matching strategy

Response

Default Response

Changes

  • afa283b82594Revision changes
    • info

      added the optional property // to the response with the status

  • 49b549b68d52Revision changes
    • breaking

      for the query request parameter colorThreshold, default value was changed from 15 to 15

    • breaking

      for the query request parameter colorThreshold, the type changed from string to number

    • warning

      for the query request parameter colorThreshold, the max was set to 100.00

    • warning

      for the query request parameter colorThreshold, the min was set to 0.00