Policies

A policy consists of three main items:

  • A policy name. This name can be freely chosen.
  • A default action. This default action is used to determine what to do with parameters that do not match any policy rules.
  • Policy parameters. For every parameter, a single default value and multiple rules can be specified (where applicable).

On invocation of a service, every request parameter which is connected to a policy parameter, is matched against the policy rules in the order they are defined. The last match determines if the specific value for the parameter is allowed or denied. In case there are no matches, the default action for the policy

Note

Please keep in mind that all modification and creation operations for policies need up to 5 minutes to propagate to the services.

Known Policy Parameters

NameDescription
location-id, location-urlid

These parameters are used to limit the services to only retrieve data for specific locations. The first form of the parameter allows to specify the locations as numeric ids (and ranges), the second form of the parameter allows to specify the locations as textual ids (including wildcards).

Type: String/Integer/Location Id

Affected services: converttime, dialcode, dstlist, places, timeservice

Note

Service parameters have to match both the location-id and the location-urlid policy parameters. If the policy default action is set to deny, this means that you have to add both parameters to the policy and configure both (it's enough to set the unused one to allow everything) – otherwise all values would be denied.
param-geo

This policy parameter is used to constrain the request parameter geo.

Type: Boolean

Affected services: dialcode, places, timeservice

param-locinfo

This policy parameter is used to constrain the request parameter locinfo.

Type: Boolean

Affected services: dialcode

param-sun

This policy parameter is used to constrain the request parameter sun.

Type: Boolean

Affected services: timeservice

param-time

This policy parameter is used to constrain the request parameter time.

Type: Boolean

Affected services: dialcode, timeservice

param-timechanges

This policy parameter is used to constrain the request parameter timechanges.

Type: Boolean

Affected services: timeservice

param-tz

This policy parameter is used to constrain the request parameter tz.

Type: Boolean

Affected services: converttime, dialcode, timeservice

service

This policy parameter actually does not constrain a request parameter, but it constrains the called service itself: services not allowed by this policy parameter cannot be called at all.

Type: String

Affected services: all

Policy Parameter Types

Depending on the parameter type, values can be specified in different ways:
TypePossible Values
Boolean

Boolean parameters have only limited policy support: it is possible to allow to enable and disable a request parameter (and specify an optional default value), or to set a Boolean request parameter to be enabled or disabled all time (this automatically includes the specified value as default value). It is not possible to specify a contradiction, i.e. to neither allow the enabled nor the disabled state for a request parameter. In case of a contradiction (i.e. by setting the policy default action to deny, and not include the parameter in the rule set), the request parameter will default to disabled.

Integer

For Integer parameters, allowed (or denied) values can be specified as exhaustive listing, as ranges or as a combination of both. Additionally it is possible to specify a default value which is used in case the parameter is not specified for the request.

String

String parameters essentially behave like Integer parameters, the difference is that instead of ranges the have to be specified by using wildcards. The * (star) character is used as a substitute for a string with zero or more characters, the ? (question mark) character is a substitute for exactly one character.

prev top | next >
Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com