Using JSON

Using JSON-RPC

The API uses JSON-RPC 2.0 over HTTP for all interaction. To access the API you need to POST a JSON document to the product class URL.

There are many implementations of JSON-RPC clients in several popular languages available. In this document we will use the Linux command line tool curl in all examples. This is done because it illustrates ‘what goes over the line’ and to remain independent of a particular implementation language.

A JSON-RPC request is a JSON document containing 4 fields:

{
    "jsonrpc": "2.0",
    "id": <correlation id>,
    "method": "<name of method to call>",
    "params": {
        "method_parameter_1": ...,
        "method_parameter_N": ...
    }
}

The method parameters (actually the entire contents of the params field) are structurally validated using JSON Schema.

Using JSON Schema

The JSON Schema files are accessible under http://api.nextpertise.nl/schemas.

There is a direct correspondance between the API URL https://api.nextpertise.nl/broadband/basic/v1 for the zipcode method and the URL for the accompanying schemas http://api.nextpertise.nl/schemas/schemas/broadband/basic/zipcode_request_v1.json and http://api.nextpertise.nl/schemas/schemas/broadband/basic/zipcode_reply_v1.json.