Locality Firefox Toolbar
version 2.0.8 (21/01/2010)
* Secure 256-bit SSL Encrypted Downloads
Install Now

Installation Instructions:

  1. 1.Click the secure* Install Now button to the left, a message bar will appear at the top of your browser.
  2. 2.Allow In the message bar, on the right hand side, click the Allow button.
  3. 3.Install A confirmation dialog will now appear, click Install Now. The toolbar will be downloaded.
  4. 4.Restart Click the Restart Firefox button to complete the process.

Local Routes Method

This method lists South African IP routes.

URL: http://extension.locality.co.za/api/0.1/network/routes-list.[data_format]
Formats: json, php
Method(s): GET
Parameters:
  1. asn (integer) [optional] Filter routes by ASN.
  2. ip (string) [optional] Filter routes by IP address, in dot quad format.
  3. since (integer) [optional] Filter routes by registration date, in UNIX timestamp format.
Response:
  1. routes (array) A numbered array of routes.
  2. > asn_origin (integer) The ASN of the owner of this block.
  3. > asn_peers (string) A space separated list of ASN peers, as seen from Route Views.
  4. > asn_peers_za (string) A space separated list of local ASN peers, as seen from AS3741.
  5. > start_ip (integer) The first IP address in this block.
  6. > end_ip (integer) The last IP address in this block.
  7. > timestamp (array) The UNIX timestamp of when this block was registered.
Example:
  1. Request: http://extension.locality.co.za/api/0.1/network/routes-list.json?asn=36943
  2. Response: 
    {
  error_msg: null,
  error_type: null,
  response: {
    routes: [
      {
        asn_origin: 36943,
        asn_peers: 5713 22355,
        asn_peers_za: 5713,
        start_ip: 699990016,
        end_ip: 700055551,
        timestamp: 1224540000
      },
      {
        asn_origin: 36943,
        asn_peers: 5713,
        asn_peers_za: 5713,
        start_ip: -992206848,
        end_ip: -992204801,
        timestamp: 1138053600
      },
      {
        asn_origin: 36943,
        asn_peers: 5713 22355,
        asn_peers_za: 5713,
        start_ip: -992200704,
        end_ip: -992198657,
        timestamp: 1138053600
      }
    ]
  },
  timestamp: 1234567890
}

Fair Usage Guidelines

Please be considerate with your requests, in other words don't make more requests than necessary. Determine whether a single or bulk request is better suited for the data you require. An example would be to consider using timestamp filtering to retrieve only the data you require since your last request. Another consideration would be to locally cache content where possible.

Creative Commons License