Conventions


When fetching a resource the type of the JSON object being returned is not specified. When a resource is successfully fetched the type of the JSON object is implicitly that of the resource being fetched. Note that this means the status code of the response must be checked before assuming the JSON object is of the expected type.

JSON objects don’t repeat the name of the parent object: The name of an contact person should be represented as

1
2
3
4
5
{
    "contactPerson": {
        "name": "John Doe"
    }
}

Dates and times use the ISO 8601 extended standard, for example: 2014-12-31 18:52:42. Some dates and times may use less precision.

All times are assumed to be Norwegian local time.

Values should be represented as an appropriate data type, avoiding conversion to strings, wherever possible.

The value null is used to mean unknown, it should not be used in place of the number 0 or an empty string.