moduluschecking-api

Modulus checking API

This package is an API to validate UK bank account numbers, supporting authentication and rate limits. This package has been presented in a blog post where you can find instructions to deploy behind Nginx.

What is modulus checking?

Modulus checking is a procedure for validating sort code and account number combinations for UK bank accounts.

Requirements

• A working Go installation
• A Redis server if you want to rate limit requests

Other packages used

For additional documentation, check out these packages I'm using:

• cloudflare/service to create the web service and provide default endpoints
• etcinit/speedbump for the rate limiting functionality
• codegangsta/negroni for middlewares
• AntoineAugusti/moduluschecking for actually validating bank account numbers

Getting started

You can grab this package with the following command:

go get github.com/AntoineAugusti/moduluschecking-api

And then build it using the Makefile:

cd ${GOPATH%/}/src/github.com/AntoineAugusti/moduluschecking-api
make build
cp moduluschecking-api ${GOPATH%/}/bin/moduluschecking-api

Building the package using the Makefile will allow the /heartbeat and /version endpoints to echo the Git hash of the current build and the date of the current build.

Usage

From the -h flag:

Usage of ./moduluschecking-api:
  -a string
        address to listen (default ":8080")

API endpoint

/verify

Purpose: Check that a UK bank account number is valid.

Request

Expected HTTP headers:

JSON payload:

{
  "sort_code":"123456",
  "account_number":"12345678"
}

Response

Success

For a status code of 200:

Body:

{
  "sort_code":"308037",
  "account_number":"87344782",
  "is_valid":false
}

Errors

Each error is given as a JSON response containing 2 keys (status and message), describing the source of the error. The Content-Type HTTP header is always set to application/json; charset=UTF-8.

Example:

{
  "status":"rate_exceeded",
  "message":"API rate exceeded. Too many requests."
}