Protoship

Lists the parts a Protoship device is built from: the always-included Arduino Nano ESP32 on its carrier, the modules (function, plug, I2C address, limits) and the enclosure options, plus the power and delivery rules. Free, no side effects.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Prices a device built from catalog modules: parts, enclosure, assembly, shipping, Protoship fee and VAT for the destination country, as one total, plus a delivery estimate, a quote_id for reserve, a reserve_url your user can open, and an ESPHome starter config. If the device breaks a rule (power, plugs, unknown part), it returns the problems to fix. Free, no side effects.

{
  "type": "object",
  "properties": {
    "parts": {
      "type": "array",
      "description": "Module ids from catalog, e.g. [\"bme280\", \"oled\"]. Repeat an id or use \"micro_servo:2\" for two. The Nano ESP32 and the carrier are always included.",
      "items": {
        "type": "string",
        "enum": [
          "bme280",
          "scd41",
          "oled",
          "servo_driver",
          "micro_servo",
          "pir",
          "relay",
          "led_ring",
          "micro_servo:2"
        ]
      }
    },
    "enclosure": {
      "type": "string",
      "enum": [
        "printed",
        "none"
      ],
      "description": "printed (default) or none."
    },
    "country": {
      "type": "string",
      "description": "Two-letter EU country code of the delivery address, e.g. DE. Default DE."
    },
    "units": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "How many identical devices. Default 1."
    }
  },
  "required": [
    "parts"
  ],
  "additionalProperties": false
}

Reserves the device from a quote for your user. No payment and no obligation to buy. Protoship sends one email to confirm the address and the reservation, and one when the device can be ordered. No newsletter. Use only your user's own email address, only after showing them the total and with their consent. Privacy policy: https://protoship.dev/privacy

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string",
      "description": "quote_id from quote."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Your user's email address."
    },
    "purpose": {
      "type": "string",
      "maxLength": 280,
      "description": "What the device is for, in a sentence. Optional."
    }
  },
  "required": [
    "quote_id",
    "email"
  ],
  "additionalProperties": false
}

Returns the state of a reservation (pending until the email is confirmed, then confirmed), the device and its total.

{
  "type": "object",
  "properties": {
    "reservation_id": {
      "type": "string",
      "description": "The id reserve returned, e.g. R-7KQ2M9XW4P."
    }
  },
  "required": [
    "reservation_id"
  ],
  "additionalProperties": false
}

Puts your user on the Protoship waitlist, for PCBs, 3D prints, CNC parts, sheet metal or devices outside the catalog. Protoship sends one email to confirm the address, later one with the invite. No newsletter. Use only your user's own email address and only with their consent. Privacy policy: https://protoship.dev/privacy

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Your user's email address."
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "pcbs",
          "3d_prints",
          "cnc_parts",
          "sheet_metal",
          "assembled_devices",
          "not_sure"
        ]
      },
      "description": "What your user wants to order. Optional."
    },
    "device": {
      "type": "string",
      "maxLength": 280,
      "description": "The device your user wants to build, in a sentence. Optional."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}