Authentication
Public API requests are authenticated with an API token in the HTTP
Authorization header.
Authorization: Bearer at_xxxxxxxx.xxxxxxxxAPI tokens are issued from the vprinter dashboard and are tied to the user that created them. A token can have one or more scopes:
| Scope | Description |
|---|---|
read | Allows read-only requests, such as reading the current user and searching prints. |
write | Allows write requests, such as creating or updating prints. write also satisfies read requirements. |
Requests with a missing, malformed, expired, revoked, or otherwise invalid token
return 401 UNAUTHORIZED.
Requests with a valid token that does not have the required scope return
403 API_TOKEN_SCOPE_INSUFFICIENT.