Formide

Formide Developer Documentation

3D printing for developers!

Get Started

Endpoints

All 3rd party available endpoints of the Formide API are listed in the API reference.

Root endpoint

The root endpoint of the Formide cloud API is https://api.formide.com. You can expect us not to change the endpoints without versioning at a later stage. You can check the API release notes for other changes.

Responses

All API responses are in JSON format. The HTTP header will contain the correct status code, which is 200 for a successful request.

Success response

When fetching a resource, the response will simply be an array or object containing the requested resource(s):

[
  {
    "id": 1,
    "property": "value"
  }
]

When creating or updating resources, there will always be a message and the created or updated object in the response:

{
  "message": "Printer created",
  "printer": {
    "id": 1,
    "property": "value"
  }
}

Error responses

Every error response is a JSON object in the same format

Not found example:

{
  "message": "The requested resource was not found",
  "statusCode": 404,
  "statusName": "Not Found"
}

Unauthorized example:

{
  "message": "No access token found or access token invalid",
  "statusCode": 401,
  "statusName": "Unauthorized"
}

Endpoints