Authentication/Keys API

• Create a new key
• Revoke a key’s access

Keys can be created and deleted, but cannot be listed as a collection or updated. To see a listing of account tokens, you must login to your account via the web at tapability.org.

Create a new key

This endpoint requires a separate X-TAP-Client-Token header that is available upon request. If you are a developer building an application for Tapability and need the ability to generate access keys, please contact support.

To create a new key, you must send HTTP Basic Authentication in the authorization header using the account email address and password. You cannot create a new token using an existing token.

POST /me/keys

Parameters

You must specify the account type so we know the type of account you’re trying to authenticate.

account_type

candidate, counselor, employer, default: candidate.

Input

description

Optional string

{
  "description": "Dwight's iPhone"
}

Response

Status: 201 Created
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

{
  "description": "Dwight's iPhone",
  "token": "Mk3W4dTvpdUNar7AB3RD4PBoT8Py9wFNZ7WakvQP",
  "created_at": "2012-12-09T17:58:26Z"
}

Revoke a key’s access

Revoke access to the specified key. This would typically be the current key that you are using to authenticate, but you can revoke other keys as well.

DELETE /me/keys/:token

Response

Status: 204 No Content
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999