Skip to navigation
aVenture APIAccount and BillingAuth

Authorize API Operations

View as Markdown
Given a list of API operation ids, returns the ones the current caller may call, together with the caller's current permissions and access level. Candidate operations are checked without being executed.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Request

This endpoint expects an object.
operationlist of objectsRequired
Generated API operation candidates to authorize.

Response headers

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
operationlist of objects
Operations from your list that the current session may call.
operationAccessenum
Highest access class represented by the current session.
Allowed values:
permissionGrantobject
Existing role and permission grant for the current session.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error