Dialing Code Service

1. Authentication
Parameter
Description
Value

Authentication Method

Required

Access Key

The access key for the request sender. This parameter identifies the account that will be charged for the request. Access keys can be created in the API control panel. Additionally, the API control panel allows to set certain preferences and restrictions per access key.

*

Example: NYczonwTxv

Required

Secret Key

The secret key associated with the access key.

*

Example: x4whvXnG7cCOBiNBoi1r

Required

Expiry Date

The date and time at which the signature for this request will expire. After this time, the request will be declined. This time stamp cannot be more than 24 hours ahead from the time the request is submitted.

*

Example: 2011-04-15T15:43:46Z

Required

Signature

The signature for the request. The signature is created by applying the HMAC-SHA1 (RFC 2104) function to a concatenation of the access key, the called service name and the signature timestamp or expiry timestamp. The resulting data has to be encoded with the Base64 method.

*

Example: 4KvntdTApUC2MO6FJQqwYeVxQX0=

2. Service Parameters
Parameter
Description
Value

"Convert From" Location ID

Specify the ID of the location you want to call from. If the location is not specified, the service will return the phone number in international format.

Documentation: Location Id


One ID only (not required)
Trial package: available data
Required

"Convert To" Location ID

Specify the ID of the location you want to call to.

Documentation: Location Id

*
One ID (required)
Trial package: available data

"Number"

Local number you want to call (without area or country code). If the number is not supplied, the calling information without the local number is returned (the number will contain the letter X instead).


Local number to call

Example: 123 456 7890

Location info

Return detailed information about the supplied locations.

Longitude/Latitude

Return longitude and latitude for the geo object.

Current time

Adds current time under the location object.

Verbose time

Adds verbose time specification to all ISO 8601 time stamps.

Time zone info

Add time zone information under the time object.

3. Output Options
Parameter
Description
Value

Output Format

The services support to output data in different formats. By default, the answer is returned in JSON format, but it is also possible to request the data in JSON-P, Javascript, XML or plain text format. While XML and JSON/Javascript formats are supported by all services, plain text is only supported by specific services. Please see the documentation for the individual services for more details. Note that the plain text output method may also include a CSV representation.

Callback Method

This parameter switches the output method to JSON-P and allows to specify the method name that should receive the result. You can choose this identifier freely to suit your needs.

Example: parseResponse

Variable Name

This parameter switches the output method to Javascript and allows to specify the variable name the output data should be assigned to.

Example: o

Prettyprint

Set this parameter to 1 to receive the XML or JSON/Javascript output with line breaks and indentations. If set to zero, or unset, the output will be returned in compact form. This parameter is not applicable to the plain text output format.

4. Result
Click the Go!-button to submit a request.
Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com