How to use the API¶
The EOSC Performance API uses REST. JSON is returned by all API responses including errors and HTTP response status codes are to designate success and failure.
All resources are documented following the OpenAPI Version 3 specification. Find the last version under performance.services.fedcloud.eu/api/v1/api-spec.json and access the API endpoint at performance.services.fedcloud.eu/api/v1.
The API endpoint can only be accessed by https, all the http attempts
301 Moved Permanently. A graphical Swagger web interface
is available at the root endpoint to provide user friendly documentation,
interface and examples.
Anonymous request example using bash:
$ curl -X 'GET' \ 'https://performance.services.fedcloud.eu/api/v1/benchmarks'
Authenticated request example using bash:
$ curl -X 'POST' \ 'https://performance.services.fedcloud.eu/api/v1/users:register' \ -H 'Authorization: Bearer <your-access-token>'