Skip to content

Commit

Permalink
Document missing plan requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
johanohly committed Oct 5, 2024
1 parent 4ed0ad9 commit 70301dd
Show file tree
Hide file tree
Showing 6 changed files with 90 additions and 3 deletions.
24 changes: 24 additions & 0 deletions source/includes/_custom_fields.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ Custom Fields allow you to add your own data-fields inside SimplyPrint.

## List custom fields

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

`POST /{id}/custom_fields/Get`

> Example request
Expand Down Expand Up @@ -87,6 +91,10 @@ curl -X POST https://api.simplyprint.io/{id}/custom_fields/Get \

## Create or update a custom field

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

`POST /{id}/custom_fields/Save`

> Example request
Expand Down Expand Up @@ -139,6 +147,10 @@ curl -X POST https://api.simplyprint.io/{id}/custom_fields/Save \

## Enable or disable a custom field

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

`POST /{id}/custom_fields/SetEnabled`

> Example request
Expand Down Expand Up @@ -176,6 +188,10 @@ curl -X POST https://api.simplyprint.io/{id}/custom_fields/SetEnabled \

## Delete custom fields

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

`GET /{id}/custom_fields/Delete`

> Example request
Expand Down Expand Up @@ -219,6 +235,10 @@ curl https://api.simplyprint.io/{id}custom_fields/Delete?ids=123,124,125 \

## Custom field submission

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

`POST /{id}/custom_fields/SubmitValues`

> Example request
Expand Down Expand Up @@ -251,6 +271,10 @@ curl -X POST https://api.simplyprint.io/{id}/custom_fields/SubmitValues \

## Custom field submission value

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

The value of a custom field when submitted via the API is an object with a key corresponding to the field type.
See the examples to the right for the different field types.

Expand Down
28 changes: 26 additions & 2 deletions source/includes/_printers.md
Original file line number Diff line number Diff line change
Expand Up @@ -606,6 +606,10 @@ you want to change the printer that is connected to a pi.

## List one-click printers

<aside class="notice">
This endpoint requires the <b>Pro</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/printers/OneClickPrint?pIds=1234,1235 \
-H 'accept: application/json' \
Expand Down Expand Up @@ -659,7 +663,7 @@ curl https://api.simplyprint.io/{id}/printers/OneClickPrint?pIds=1234,1235 \
## AutoPrint enable / disable

<aside class="notice">
AutoPrint requires the <b>Print Farm</b> plan.
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
Expand Down Expand Up @@ -698,10 +702,14 @@ curl https://api.simplyprint.io/{id}/printers/autoprint/SetEnabled \

## AutoPrint check state

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/printers/autoprint/CheckState \
-H 'accept: application/json' \
-H 'X-API-KEY: {API_KEY}' \
-H 'X-API-KEY: {API_KEY}'
```

> Success response
Expand Down Expand Up @@ -741,6 +749,10 @@ curl https://api.simplyprint.io/{id}/printers/autoprint/CheckState \

## AutoPrint get settings

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/printers/autoprint/GetAutoPrintSettings \
-H 'accept: application/json' \
Expand Down Expand Up @@ -787,6 +799,10 @@ curl https://api.simplyprint.io/{id}/printers/autoprint/GetAutoPrintSettings \

## AutoPrint save settings

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/printers/autoprint/SaveAutoPrintSettings \
-X POST \
Expand Down Expand Up @@ -836,6 +852,10 @@ curl https://api.simplyprint.io/{id}/printers/autoprint/SaveAutoPrintSettings \

## AutoPrint get gcode templates

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/printers/autoprint/GetGcodeTemplates \
-H 'accept: application/json' \
Expand Down Expand Up @@ -887,6 +907,10 @@ curl https://api.simplyprint.io/{id}/printers/autoprint/GetGcodeTemplates \

## AutoPrint set cleared beds amount

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/printers/autoprint/SetClearedBedsAmount \
-X POST \
Expand Down
4 changes: 4 additions & 0 deletions source/includes/_queue.md
Original file line number Diff line number Diff line change
Expand Up @@ -691,6 +691,10 @@ This endpoint empties the queue.

## Revive item

<aside class="notice">
This endpoint requires the <b>Print Farm</b> plan.
</aside>

```shell
curl https://api.simplyprint.io/{id}/queue/ReviveItem?job=1234 \
-H 'accept: application/json' \
Expand Down
8 changes: 8 additions & 0 deletions source/includes/_schools.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## List classes

<aside class="notice">
This endpoint is only available on the <b>School</b> plan.
</aside>

`GET /{id}/account/settings/school/classes/GetClasses`

> Example request
Expand Down Expand Up @@ -75,6 +79,10 @@ curl https://api.simplyprint.io/{id}/account/settings/school/classes/GetClasses

## Create or update a class

<aside class="notice">
This endpoint is only available on the <b>School</b> plan.
</aside>

`POST /{id}/account/settings/school/classes/SaveClass`

> Example Request
Expand Down
9 changes: 8 additions & 1 deletion source/includes/_users.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,10 @@ curl https://api.simplyprint.io/{id}/users/GetPaginatedUsers \
"total_prints": 68,
"rank": 185,
"teacher": false,
"classes": [1234, 5678]
"classes": [
1234,
5678
]
}
],
"page_amount": 1
Expand Down Expand Up @@ -357,6 +360,10 @@ This endpoint deletes a user from the company. Use this endpoint with caution.

## Set Teacher

<aside class="notice">
This endpoint is only available on the <b>School</b> plan.
</aside>

`POST /{id}/users/SetIsTeacher`

> Example request
Expand Down
20 changes: 20 additions & 0 deletions source/includes/_webhooks.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ When one of those events is triggered, we'll send an HTTP POST payload to the we

## List webhooks

<aside class="notice">
This endpoint is only available on the <b>Print Farm</b> plan.
</aside>

`GET /{id}/webhooks/Get`

> Example request
Expand Down Expand Up @@ -65,6 +69,10 @@ curl "https://api.simplyprint.io/{id}/webhooks/Get" \

## Create or update a webhook

<aside class="notice">
This endpoint is only available on the <b>Print Farm</b> plan.
</aside>

`POST /{id}/webhooks/Create`

> Example request
Expand Down Expand Up @@ -123,6 +131,10 @@ https://api.simplyprint.io/{id}/webhooks/Create \

## Delete a webhook

<aside class="notice">
This endpoint is only available on the <b>Print Farm</b> plan.
</aside>

`POST /{id}/webhooks/Delete`

> Example request
Expand Down Expand Up @@ -160,6 +172,10 @@ https://api.simplyprint.io/{id}/webhooks/Delete \

## Enable or disable a webhook

<aside class="notice">
This endpoint is only available on the <b>Print Farm</b> plan.
</aside>

`POST /{id}/webhooks/SetEnabled`

> Example request
Expand Down Expand Up @@ -198,6 +214,10 @@ https://api.simplyprint.io/{id}/webhooks/SetEnabled \

## Manually trigger webhook

<aside class="notice">
This endpoint is only available on the <b>Print Farm</b> plan.
</aside>

The event type will be `test`.

`POST /{id}/webhooks/TriggerTestWebhook`
Expand Down

0 comments on commit 70301dd

Please sign in to comment.