Printago Documentation

website·Indexed 33 days ago

https://docs.printago.io

Technical documentation and OpenAPI 3.1.0 specification for the Printago API, covering getting started guides, printer connectivity, CadQuery, plate merging, and API endpoint schemas.

Tokens
34.9K
Snippets
210
Records
281
Agent score
58%

What's inside Printago

  1. Manage the Print Queue and Smart Matching

    The Printago queue manages job interaction, priority, and automatic printer assignment. 'Smart Matching' uses specific criteria and assignment strategies to match jobs to the most appropriate available printer based on material and machine profiles.
  2. Manage Printago Addons

    Printago uses Addons to extend functionality. Users can pin addons to the sidebar for quick access. Available addons include 'Classwork' (for teacher/student roles, assignment management, and print tracking) and 'Cost Catalog' (for managing SKU costs and margins).
  3. SkuBuildWithRelation object schema

    The SkuBuildWithRelation object provides details about a SKU's build configuration, including a copy of the SKU's metadata (title, description, external provider) and its associated store and folder IDs.
    {
      "type": "object",
      "properties": {
        "skuId": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-z0-9]{24}$" }] },
        "skuCopy": {
          "type": "object",
          "properties": {
            "sku": { "type": "string", "minLength": 1, "maxLength": 1024 },
            "title": { "type": "string" },
            "description": { "type": "string" },
            "externalId": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1, "maxLength": 1024 }] },
            "externalProvider": { "oneOf": [{ "type": "null" }, { "const": "etsy" }, { "const": "shopify" }] },
            "folderId": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-z0-9]{24}$" }] },
            "id": { "type": "string", "pattern": "^[a-z0-9]{24}$" },
            "storeId": { "type": "string", "pattern": "^[a-z0-9]{24}$" },
            "createdAt": { "type": "string" },
            "updatedAt": { "type": "string" }
          },
          "required": ["sku", "title", "description", "externalId", "externalProvider", "id", "storeId", "createdAt", "updatedAt"]
        }
      }
    }
  4. Printago Platform Overview

    Printago is a cloud-based print farm management system designed for print farm owners, educational institutions, engineering teams, and print-on-demand services. Key features include zero hardware requirements, native customization support, intelligent queue management, direct e-commerce integration, and a powerful API.
  5. Manage Print Sequences and Serial Numbers

    Sequences allow for the tracking of serial numbers or unique identifiers for printed parts. They can be attached to SKUs and support serial reuse on a plate via 3MF text placeholders. Printago provides a 'never-reissue guarantee' for sequences to ensure serial integrity during retries or cancellations.
  6. Manage printer maintenance with Maintenance Tracker

    The Maintenance Tracker add-on allows users to track printer health and schedule service tasks. Key features include:

    • Maintenance Items: Create custom items with specific trigger types to track when parts need replacing or servicing.
    • Enrollments: Assign specific maintenance tasks to individual printers or groups of printers.
    • Maintenance Mode: Enable this mode to prevent a printer from accepting new jobs while it is being serviced.
    • Fleet Status: Monitor the overall health and overdue tasks across all printers via the Fleet Status and Timeline tabs.
    • Tracking: Print hour usage is counted to trigger maintenance alerts based on realistic intervals.
  7. Set up Printago for Education

    Printago provides a specialized workflow for schools involving IT Admins, Teachers/Staff, Lab management, and Students. It includes features for free student accounts and managing shared labs where multiple teachers collaborate.
  8. Install Printago as a Progressive Web App (PWA)

    Printago can be installed as a PWA across various platforms:

    • Windows: Via Chrome or Edge.
    • macOS: Via Chrome or Safari.
    • iOS/iPadOS: Via Safari.
    • Android: Via Chrome.
  9. Manage and Assign 3D Printing Materials

    Printago uses a system of Base Materials and Material Variants (colors) to manage filaments. Materials can be added manually or via a built-in database. The system supports material matching levels to automatically pair jobs with printers based on available material slots, including support for multi-color 3MF files and dual-color filaments.
  10. PrintJobMaterialMapping schema definition

    The PrintJobMaterialMapping object defines the material requirements for a specific slot in a print job. It tracks the material ID, type, and associated user or system profiles.
    {
      "type": "object",
      "properties": {
        "slot": { "type": "number" },
        "skip": { "type": "boolean" },
        "variantId": { "type": "string" },
        "materialId": { "type": "string" },
        "materialType": { "type": "string" },
        "name": { "type": "string" },
        "filamentUserProfileId": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-z0-9]{24}$" }] },
        "filamentSystemProfileId": { "oneOf": [{ "type": "null" }, { "type": "number" }] }
      },
      "required": [ "slot" ]
    }