IP Locator:Request: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 21: | Line 21: | ||
|Customer ID||id||CustomerID | |Customer ID||id||CustomerID | ||
|- | |- | ||
|Record ID||rowspan=" | |Record ID||rowspan="3" valign="center"|Record|| ||RecordID | ||
|- | |- | ||
|IP Address||ip||IPAddress | |IP Address||ip||IPAddress | ||
|- | |||
|Output Columns||cols||Cols | |||
|} | |} | ||
| Line 99: | Line 101: | ||
|- | |- | ||
|REST||<code>&ip = '''''string'''''</code> | |REST||<code>&ip = '''''string'''''</code> | ||
|} | |||
<h3 class="h3grey">Output Columns</h3> | |||
:''Optional.'' | |||
:Return full or partial domain information. | |||
:For example: | |||
:*<code>-cols=grpdomaininfo</code> will return the full domain information. | |||
:*While <code>-cols=DomainCountry,DomainAgeEstimated,DomainAddress1,DomainAdministrativeArea</code> will only return the selected domain output columns. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"Cols":"'''''string'''''"</code> | |||
|- | |||
|REST||<code>&cols = '''''string'''''</code> | |||
|} | |} | ||
Revision as of 18:16, 15 July 2021
| Global IP Navigation | |||
|---|---|---|---|
| |||
| |||
| |||
| |||
| Sample Code |
A request consists of a protocol to make a call to the service, detailing desired elements. The minimum required elements in a request are your Customer ID (License Key) and at least one input IP address.
IP Locator supports JSON and REST protocols.
Field Names
This is a list of the request field names and their protocol naming conventions.
| Field Name | Level | REST | JSON |
|---|---|---|---|
| Transmission Reference | Request | t | TransmissionReference |
| Customer ID | id | CustomerID | |
| Record ID | Record | RecordID | |
| IP Address | ip | IPAddress | |
| Output Columns | cols | Cols |
Request Elements
The following elements set the basic options for each request. These apply to the entire request, not the individual records.
Transmission Reference
- Optional.
- This is a string value that serves as a unique identifier for this set of records. It is returned as sent.
Protocol Syntax JSON "TransmissionReference":"string"REST ?t = string
Customer ID
- Required.
- This is a string value containing the License Key issued to the customer by Melissa Data for IP Locator.
- If this element is absent, the Web Service will return an error. To receive a License Key, please contact your Melissa Data sales representative at 1-800-MELISSA.
Protocol Syntax JSON "CustomerID":"string"REST &id = string
Request Record Elements
JSON will contain the Records element.
| Protocol | Definition |
|---|---|
| JSON | Each IP address will be contained within [{}] under the Records element. |
| REST | The REST interface only allows a single record per request. |
RecordID
- Optional.
- This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted.
Protocol Syntax JSON "RecordID":"string"
IPAddress
- Required.
- The IP address to be verified.
- Both IPv4 and IPv6 Input Formats are supported. For example:
IPv4: 127.0.0.1 IPv6: 2001:db8:85a3:0:0:8a2e:370:7334
Protocol Syntax JSON "IPAddress":"string"REST &ip = string
Output Columns
- Optional.
- Return full or partial domain information.
- For example:
-cols=grpdomaininfowill return the full domain information.- While
-cols=DomainCountry,DomainAgeEstimated,DomainAddress1,DomainAdministrativeAreawill only return the selected domain output columns.
Protocol Syntax JSON "Cols":"string"REST &cols = string