IP Locator:Request: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 17: | Line 17: | ||
!Field Name !! Level !! REST !! JSON | !Field Name !! Level !! REST !! JSON | ||
|- | |- | ||
|Transmission Reference||rowspan=" | |Transmission Reference||rowspan="3" valign="center"|Request||t||TransmissionReference | ||
|- | |- | ||
|Customer ID||id||CustomerID | |Customer ID||id||CustomerID | ||
|- | |- | ||
|Record ID||rowspan=" | |Output Columns||cols||Columns | ||
|- | |||
|Record ID||rowspan="2" valign="center"|Record|| ||RecordID | |||
|- | |- | ||
|IP Address||ip||IPAddress | |IP Address||ip||IPAddress | ||
|} | |} | ||
| Line 116: | Line 116: | ||
!Protocol !! Syntax | !Protocol !! Syntax | ||
|- | |- | ||
|JSON||<code>" | |JSON||<code>"Columns":"'''''string'''''"</code> | ||
|- | |- | ||
|REST||<code>&cols = '''''string'''''</code> | |REST||<code>&cols = '''''string'''''</code> | ||
Latest revision as of 01:01, 12 November 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 | |
| Output Columns | cols | Columns | |
| Record ID | Record | RecordID | |
| IP Address | ip | IPAddress |
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 "Columns":"string"REST &cols = string