Skip to content

Latest commit

 

History

History
76 lines (48 loc) · 1.12 KB

File metadata and controls

76 lines (48 loc) · 1.12 KB

oyster-api Codacy Badge

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

Deploy

Licence

MIT