Resource Normalization

Resource

Normalization

Workspace

Sentinel Services

Path

/normalization

Operations

Operation

Retrieve a list of sub-resources offered by this resource

Request Method

GET

Path

/normalization

Parameters

Request Body

Not used

Success Result

200 OK

Response Headers

None

Response Body

Feature

/normalization/addresslists

Operation

Retrieve a listing of address lists

Request Method

GET

Path

/normalization/addresslists

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

  • page — the page to retrieve if results span multiple pages (default = 1 if not provided)

Request Body

Not used

Success Result

200 OK

Response Headers

None

Response Body

AddressLists

/normalization/addresslists/config

Operation

Create a new address list

Request Method

POST

Path

/normalization/addresslists/config

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

AddressListConfig

Success Result

201 Created

Response Headers

Location — contains the URL to access the created record

Response Body

Not used

Operation

Retrieve an existing address list config

Request Method

GET

Path

/normalization/addresslists/config/{listName}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

Not used

Success Result

200 OK

Response Headers

None

Response Body

AddressListConfig

Operation

Update an existing address list config

Request Method

PUT

Path

/normalization/addresslists/config/{listName}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

AddressListConfig

Success Result

204 No content

Response Headers

None

Response Body

Not used

Operation

Delete an existing address list

Request Method

DELETE

Path

/normalization/addresslists/config/{listName}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

Not used

Success Result

204 No content

Response Headers

None

Response Body

Not used

/normalization/addresslists/lists

Operation

Create a new Normalization Address List Entries entry

Request Method

POST

Path

/normalization/addresslists/lists/{listName}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

AddressListEntry

Success Result

201 Created

Response Headers

Location — contains the URL to access the created record

Response Body

Not used

Operation

Update an existing Normalization Address List Entries entry

Request Method

PUT

Path

/normalization/addresslists/lists/{listName}/{address}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

AddressListEntry

Success Result

204 No content

Response Headers

None

Response Body

Not used

Operation

Retrieve a listing of address list entries

Request Method

GET

Path

/normalization/addresslists/lists/{listName}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

  • page — the page to retrieve if results span multiple pages (default = 1 if not provided)

Request Body

Not used

Success Result

200 OK

Response Headers

None

Response Body

AddressListEntries

Operation

Retrieve an existing address list entry

Request Method

GET

Path

/normalization/addresslists/lists/{listName}/{address}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

Not used

Success Result

200 OK

Response Headers

None

Response Body

AddressListEntry

Operation

Delete an existing address list entry

Request Method

DELETE

Path

/normalization/addresslists/lists/{listName}/{address}

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

Not used

Success Result

204 No content

Response Headers

None

Response Body

Not used

/normalization/config

Operation

Create a new Normalization Config entry

Request Method

POST

Path

/normalization/config

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

NormalizationConfig

Success Result

201 Created

Response Headers

Location — contains the URL to access the created record

Response Body

Not used

Operation

Retrieve an existing Normalization Config entry or a listing of Normalization Config entries

Request Method

GET

Path

/normalization/config

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

  • page — the page to retrieve if results span multiple pages (default = 1 if not provided)

Request Body

Not used

Success Result

200 OK

Response Headers

None

Response Body

If scope is provided: NormalizationConfig Otherwise: NormalizationConfigs

Operation

Update an existing Normalization Config entry

Request Method

PUT

Path

/normalization/config

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

NormalizationConfig

Success Result

204 No content

Response Headers

None

Response Body

Not used

Operation

Delete an existing Normalization Config entry

Request Method

DELETE

Path

/normalization/config

Parameters

  • rhinoInstanceId — the ID of the Rhino instance to connect to (as defined in REM)

  • selectionKey — the Sentinel selection key scope to use

Request Body

Not used

Success Result

204 No content

Response Headers

None

Response Body

Not used

Schemas

Feature

Class: com.opencloud.sentinel.rest.common.Feature

JSON
{
  "type" : "object",
  "properties" : {
    "name" : {
      "type" : "string"
    },
    "resources" : {
      "type" : "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "rel" : {
            "type" : "string"
          },
          "href" : {
            "type" : "string"
          },
          "title" : {
            "type" : "string"
          }
        }
      }
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="feature" type="FeatureType"/>

  <xs:element name="link" type="LinkType"/>

  <xs:complexType name="FeatureType">
    <xs:sequence>
      <xs:element name="name" type="xs:string" minOccurs="0"/>
      <xs:element name="resources" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element ref="link" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="LinkType">
    <xs:sequence/>
    <xs:attribute name="rel" type="xs:string"/>
    <xs:attribute name="href" type="xs:string"/>
    <xs:attribute name="title" type="xs:string"/>
  </xs:complexType>
</xs:schema>

AddressLists

Class: com.opencloud.sentinel.rest.common.AddressLists

JSON
{
  "type" : "object",
  "properties" : {
    "lists" : {
      "type" : "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "name" : {
            "type" : "string"
          },
          "resources" : {
            "type" : "array",
            "items" : {
              "type" : "object",
              "properties" : {
                "rel" : {
                  "type" : "string"
                },
                "href" : {
                  "type" : "string"
                },
                "title" : {
                  "type" : "string"
                }
              }
            }
          }
        }
      }
    },
    "next" : {
      "type" : "string"
    },
    "prev" : {
      "type" : "string"
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="addressList" type="AddressListsEntryType"/>

  <xs:element name="addressLists" type="AddressListsType"/>

  <xs:element name="link" type="LinkType"/>

  <xs:complexType name="AddressListsType">
    <xs:sequence>
      <xs:element ref="addressList" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="next" type="xs:string"/>
    <xs:attribute name="prev" type="xs:string"/>
  </xs:complexType>

  <xs:complexType name="AddressListsEntryType">
    <xs:complexContent>
      <xs:extension base="simpleEntry">
        <xs:sequence/>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>

  <xs:complexType name="simpleEntry" abstract="true">
    <xs:sequence>
      <xs:element name="name" type="xs:string" minOccurs="0"/>
      <xs:element name="resources" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element ref="link" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="LinkType">
    <xs:sequence/>
    <xs:attribute name="rel" type="xs:string"/>
    <xs:attribute name="href" type="xs:string"/>
    <xs:attribute name="title" type="xs:string"/>
  </xs:complexType>
</xs:schema>

AddressListConfig

Class: com.opencloud.sentinel.provisioning.addresslists.AddressListConfig

JSON
{
  "type" : "object",
  "properties" : {
    "name" : {
      "type" : "string"
    },
    "description" : {
      "type" : "string"
    },
    "defaultSearchMode" : {
      "type" : "integer"
    },
    "shouldCache" : {
      "type" : "boolean",
      "required" : true
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="addressListConfig" type="AddressListConfigType"/>

  <xs:complexType name="AddressListConfigType">
    <xs:sequence>
      <xs:element name="name" type="xs:string" minOccurs="0"/>
      <xs:element name="description" type="xs:string" minOccurs="0"/>
      <xs:element name="defaultSearchMode" type="xs:int"/>
      <xs:element name="shouldCache" type="xs:boolean"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

AddressListEntry

Class: com.opencloud.sentinel.provisioning.addresslists.AddressListEntry

JSON
{
  "type" : "object",
  "properties" : {
    "address" : {
      "type" : "string"
    },
    "description" : {
      "type" : "string"
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="addressListEntry" type="AddressListEntryType"/>

  <xs:complexType name="AddressListEntryType">
    <xs:sequence>
      <xs:element name="address" type="xs:string" minOccurs="0"/>
      <xs:element name="description" type="xs:string" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

AddressListEntries

Class: com.opencloud.sentinel.rest.common.AddressListEntries

JSON
{
  "type" : "object",
  "properties" : {
    "addresses" : {
      "type" : "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "name" : {
            "type" : "string"
          },
          "resources" : {
            "type" : "array",
            "items" : {
              "type" : "object",
              "properties" : {
                "rel" : {
                  "type" : "string"
                },
                "href" : {
                  "type" : "string"
                },
                "title" : {
                  "type" : "string"
                }
              }
            }
          }
        }
      }
    },
    "next" : {
      "type" : "string"
    },
    "prev" : {
      "type" : "string"
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="addressListEntries" type="AddressListEntriesType"/>

  <xs:element name="addressListEntry" type="AddressListEntriesEntryType"/>

  <xs:element name="link" type="LinkType"/>

  <xs:complexType name="AddressListEntriesType">
    <xs:sequence>
      <xs:element ref="addressListEntry" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="next" type="xs:string"/>
    <xs:attribute name="prev" type="xs:string"/>
  </xs:complexType>

  <xs:complexType name="AddressListEntriesEntryType">
    <xs:complexContent>
      <xs:extension base="simpleEntry">
        <xs:sequence/>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>

  <xs:complexType name="simpleEntry" abstract="true">
    <xs:sequence>
      <xs:element name="name" type="xs:string" minOccurs="0"/>
      <xs:element name="resources" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element ref="link" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="LinkType">
    <xs:sequence/>
    <xs:attribute name="rel" type="xs:string"/>
    <xs:attribute name="href" type="xs:string"/>
    <xs:attribute name="title" type="xs:string"/>
  </xs:complexType>
</xs:schema>

NormalizationConfig

Class: com.opencloud.sentinel.provisioning.normalization.NormalizationConfig

JSON
{
  "type" : "object",
  "properties" : {
    "nationalPrefix" : {
      "type" : "string"
    },
    "countryCode" : {
      "type" : "string"
    },
    "networkDialingCode" : {
      "type" : "string"
    },
    "internationalEscapeCode" : {
      "type" : "string"
    },
    "normalizeTo" : {
      "type" : "string"
    },
    "profileVersion" : {
      "type" : "integer"
    },
    "minNormalizableLength" : {
      "type" : "integer"
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="normalizationConfig" type="NormalizationConfigType"/>

  <xs:complexType name="NormalizationConfigType">
    <xs:sequence>
      <xs:element name="nationalPrefix" type="xs:string" minOccurs="0"/>
      <xs:element name="countryCode" type="xs:string" minOccurs="0"/>
      <xs:element name="networkDialingCode" type="xs:string" minOccurs="0"/>
      <xs:element name="internationalEscapeCode" type="xs:string" minOccurs="0"/>
      <xs:element name="normalizeTo" type="xs:string" minOccurs="0"/>
      <xs:element name="profileVersion" type="xs:int"/>
      <xs:element name="minNormalizableLength" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

NormalizationConfigs

Class: com.opencloud.sentinel.rest.server.resources.normalization.NormalizationConfigResource$NormalizationConfigs

JSON
{
  "type" : "object",
  "properties" : {
    "entries" : {
      "type" : "array",
      "items" : {
        "type" : "object",
        "properties" : {
          "name" : {
            "type" : "string"
          },
          "resources" : {
            "type" : "array",
            "items" : {
              "type" : "object",
              "properties" : {
                "rel" : {
                  "type" : "string"
                },
                "href" : {
                  "type" : "string"
                },
                "title" : {
                  "type" : "string"
                }
              }
            }
          },
          "selectionKey" : {
            "type" : "string"
          }
        }
      }
    },
    "next" : {
      "type" : "string"
    },
    "prev" : {
      "type" : "string"
    }
  }
}
XML
<?xml version="1.0" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="link" type="LinkType"/>

  <xs:element name="normalizationConfig" type="NormalizationConfigsEntryType"/>

  <xs:element name="normalizationConfigs" type="NormalizationConfigsType"/>

  <xs:complexType name="NormalizationConfigsType">
    <xs:sequence>
      <xs:element ref="normalizationConfig" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="next" type="xs:string"/>
    <xs:attribute name="prev" type="xs:string"/>
  </xs:complexType>

  <xs:complexType name="NormalizationConfigsEntryType">
    <xs:complexContent>
      <xs:extension base="simpleEntry">
        <xs:sequence>
          <xs:element name="selectionKey" type="xs:string" minOccurs="0"/>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>

  <xs:complexType name="simpleEntry" abstract="true">
    <xs:sequence>
      <xs:element name="name" type="xs:string" minOccurs="0"/>
      <xs:element name="resources" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element ref="link" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="LinkType">
    <xs:sequence/>
    <xs:attribute name="rel" type="xs:string"/>
    <xs:attribute name="href" type="xs:string"/>
    <xs:attribute name="title" type="xs:string"/>
  </xs:complexType>
</xs:schema>
Previous page Next page