Purpose
Parameters
token
string
100
required
Authentication token for either an application or session.
application
string
200
Slug of application being requested. This is used to determine the role being used to make the request and therefore evaluate if the requester has the correct permissions.
Possible values
- planoauth
- planoorder
- planox2
session_view
string
300
View of session object you would like returned.
itemable_type
string
400
required
itemable_id
integer
400
required
sourceable_id
integer
400
sourceable_type
string
400
key
string
400
service_id
integer
500
service_name
string
600
service_description
string
700
group_name
string
800
service_type_primary
boolean
900
quantity
integer
1000
instructions
string
1100
Max String Length: 1000
price
float
1200
base_price
float
1300
unit_price
float
1400
gross_price
float
1500
net_price
float
1600
base_price_final
float
1700
unit_price_final
float
1800
discount
float
1900
discount_applied_percent
float
2000
updated_in
string
2100
updated_at_fm
string
2200
processed_at
string
2300
Request Body Example:
application/json
Responses
action-successful
200
This status indicates that the request was successful. If the request returns data, it can be found in the data key.
invalid-token
401
This status is returned when the authentication token passed is invalid.
session-expired
401
This status is returned a session is older than seven days or hasn't been used in 72 hours. The user will need to reauthenticate. We allow our users to save a remember_me preference which will make there sessions last indefinitely.
client-required
401
This status is returned when the user makeing the request doesn't have a client, employee or liaison record. This means that they don't have any roles or permissions. Because we only allow our clients to register as a client, the user should be redirected to the PlanoAuth clients registration page where they can use the `/api/v1/users/client_register` API to register as a client. Eventhough the request will not be successful, this status will still return a `session` object because a session token is needed to register as a user.
missing-param
400
This status is returned when a required param was not passed with the request.
invalid-param
400
This status is returned when a param was invalid when passed. For example, passing an id that doesn't exist or passing an invalid email address.
application-crash
500
This status is returned when there is an internal server error. Please try again later.
mandrill-email-failed
500
This status is returned when there was an issue using Mandrill to send an email. Any time this response is returned, there will be a notification in the production notifications tab so the dev team will be away of the failure. These errors will most likely correlate with a data issue and will need to be invesigated.
invalid-content-type
400
This status is returned if the request was made with the incorrect content-type so the request params could not be read. For more infromation on content-type, please refer to https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Type.
route-non-existent
500
Response returned when HTTP route does not exist.
Uncommon Responses
The responses below are not very common.
no-params-decoded
Uncommon
This status is returned the request body was decoded, but no params where found.
invalid-encoded-params
Uncommon
This status is returned when the request body could not be decoded properly. This generally means that you are requesting a sensative_params API and your request body was not base64 encoded.
route-not-found
Uncommon
This status is returned when the route record being requested hasn't been deployed yet.
identify-request-error
Uncommon
This status is returned when there is an internal server error before the route could be identified. Please try again later.
service-not-found
Uncommon
This status is returned when the route's API service record being requested hasn't been deployed yet.