Skip to content

Latest commit

 

History

History
61 lines (42 loc) · 2.14 KB

README.md

File metadata and controls

61 lines (42 loc) · 2.14 KB
Raw

Resource Guru API

This is a REST-style API that uses serialized JSON and OAuth 2 authentication.

Making Requests

The Base URL

All requests start with the https://api.resourceguruapp.com/ base URL.

  • All requests are done via SSL.
  • All responses are in JSON.

Making a Basic Request

With the exception of Accounts all requests must be appended with the account subdomain and the path.

To make a request for all the Resources on the Example Corp account, the request URL will look something like this https://api.resourceguruapp.com/v1/example-corp/resources.

Authentication

In order to make authorized calls to Resource Guru's API, your application must first obtain an OAuth access token. To register your app go to https://developers.resourceguruapp.com.

Resource Guru implements OAuth2 with the authentication code flow.

Read our OAuth2 authentication guide to get started.

Once you have authenticated, you can get information about the authenticated user by calling GET https://api.resourceguruapp.com/v1/me. More details about the request and response are available on the endpoint page.

Rate Limiting

You can perform up to 25 requests per 10 second period on an account with one OAuth token. If you exceed this limit, you'll get a 403 Rate Limit Exceeded response for subsequent requests. Check the Retry-After header to see how many seconds to wait before retrying the request.

Response Codes

  • 200 OK
  • 201 Created
  • 204 No Content
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not Found
  • 422 Unprocessable Entity
  • 5xx Resource Guru is having trouble

Endpoints