oyster-api

Unofficial API to check Oyster balance.

API Docs

Authentication

Oyster API uses HTTP Basic authentication using you oyster username and password.

$ curl http://localhost:3000/balance -u username:password

Invalid Authentication Response

HTTP/1.1 401

{
  "error": "Authentication Invalid"
}

Missing Credentials

HTTP/1.1 401

{
  "error": "Authentication Not Provided"
}

Methods

Validate Authentication (Requires Authentication)

GET /valid_auth

If authentication is valid:

HTTP/1.1 200

{
  "valid_auth": true
}

Else if authentication fails a JSON object with an error key is returned describing the issue.

Checking Balance (Requires Authentication)

GET /balance

HTTP/1.1 200

{
  "balance": 17.7
}

Running Locally

git clone https://github.com/bencevans/oyster-api.git
cd oyster-api
npm install
npm start

Deployment

Licence

MIT