Global Email V3:Response: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{GlobalEmailNav
{{GlobalEmailV3Nav
|InputOutputCollapse=
|InputOutputCollapse=
}}
}}
Line 15: Line 15:


{| class="alternate01 sortable"
{| class="alternate01 sortable"
!Field Name !! Level !! JSON
!Field Name !! Level !! JSON/XML
|- style="vertical-align:top;"
|Version||Request||Version
|-
|-
|Transmission Reference||Request||TransmissionReference
|Version||rowspan="4" valign="center"|Response (Base)||Version
|-
|-
|Transmission Results||Request||TransmissionResults
|Transmission Reference||TransmissionReference
|-
|-
|Total Records||Request||TotalRecords
|Transmission Results||TransmissionResults
|-
|-
|Record ID||Record||RecordID
|Total Records||TotalRecords
|-
|-
|Results||Record||Results
|Record ID||rowspan="8" valign="center"|Record||RecordID
|-
|-
|Email Address||Record||EmailAddress
|Results||Results
|-
|-
|Mailbox Name||Record||MailboxName
|Email Address||EmailAddress
|-
|-
|Domain Name||Record||DomainName
|Mailbox Name||MailboxName
|-
|-
|Top Level Domain||Record||TopLevelDomain
|Domain Name||DomainName
|-
|-
|Top Level Domain Name||Record||TopLevelDomainName
|Top Level Domain||TopLevelDomain
|-
|-
|Date Checked||Record||DateChecked
|Top Level Domain Name||TopLevelDomainName
|-
|Date Checked||DateChecked
|}
|}


Line 46: Line 46:
The following elements are the basic options for each request. These apply to the entire response, not the individual records.
The following elements are the basic options for each request. These apply to the entire response, not the individual records.


<h3 style="background-color:rgb240,240,240;">Version</h3>
<h3 style="background-color:rgb(240,240,240);">Version</h3>
:This is a string value that is the current revision number of Global Email.
:This is a string value that is the current revision number of Global Email.


Line 52: Line 52:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“Version”:”string”
|JSON||<code>"Version":"'''''string'''''"</code>
|-
|SOAP||<urn:Version>?</urn:Version>
|-
|-
|XML||<Version>string</Version>
|SOAP/XML||<code><Version>'''''string'''''</Version></code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Transmission Reference</h3>
<h3 style="background-color:rgb(240,240,240);">Transmission Reference</h3>
:This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
:This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.


Line 66: Line 64:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“TransmissionReference”:”string”
|JSON||<code>"TransmissionReference":"'''''string'''''"</code>
|-
|SOAP||<urn:TransmissionReference>?</urn:TransmissionReference>
|-
|-
|XML||<TransmissionReference>string</TransmissionReference>
|SOAP/XML||<code><TransmissionReference>'''''string'''''</TransmissionReference></code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Transmission Results</h3>
<h3 style="background-color:rgb(240,240,240);">Transmission Results</h3>
:This is a string value that lists error codes from any errors caused by the most recent request as a whole.
:This is a string value that lists error codes from any errors caused by the most recent request as a whole.


Line 82: Line 78:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“TransmissionResults”:”string”
|JSON||<code>"TransmissionResults":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:TransmissionResults>?</urn:TransmissionResults>
|SOAP/XML||<code><TransmissionResults>'''''string'''''</TransmissionResults></code>
|-
|XML||<TransmissionResults>string</TransmissionResults>
|}
|}




<h3 style="background-color:rgb240,240,240;">Total Records</h3>
<h3 style="background-color:rgb(240,240,240);">Total Records</h3>
:Displays the total number of records returned.
:Displays the total number of records returned.


Line 96: Line 90:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“TotalRecords”:”string”
|JSON||<code>"TotalRecords":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:TotalRecords>?</urn:TotalRecords>
|SOAP/XML||<code><TotalRecords>'''''string'''''</TotalRecords></code>
|-
|XML||<TotalRecords>string</TotalRecords>
|}
|}


Line 110: Line 102:
!Protocol !! Definition
!Protocol !! Definition
|-
|-
|JSON, JSONP||Each record will be contained within [{}] under the Records element.
|JSON||Each record will be contained within [{}] under the Records element.
|-
|-
|SOAP||
|SOAP||
Line 120: Line 112:




<h3 style="background-color:rgb240,240,240;">Record ID</h3>
<h3 style="background-color:rgb(240,240,240);">Record ID</h3>
:This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
:This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.


Line 126: Line 118:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“RecordID”:”string”
|JSON||<code>"RecordID":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:RecordID>?</urn:RecordID>
|SOAP/XML||<code><RecordID>'''''string'''''</RecordID></code>
|-
|XML||<RecordID>string</RecordID>
|}
|}




<h3 style="background-color:rgb240,240,240;">Results</h3>
<h3 style="background-color:rgb(240,240,240);">Results</h3>
:This is a string value with comma delimited status, error codes, and change codes for the record.
:This is a string value with comma delimited status, error codes, and change codes for the record.


Line 142: Line 132:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“Results”:”string”
|JSON||<code>"Results":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:Results>?</urn:Results>
|SOAP/XML||<code><Results>'''''string'''''</Results></code>
|-
|XML||<Results>string</Results>
|}
|}




<h3 style="background-color:rgb240,240,240;">Email Address</h3>
<h3 style="background-color:rgb(240,240,240);">Email Address</h3>
:This is a string value listing the email address, including any corrections or changes made by Global Email.
:This is a string value listing the email address, including any corrections or changes made by Global Email.


Line 156: Line 144:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“EmailAddress”:”string”
|JSON||<code>"EmailAddress":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:EmailAddress>?</urn:EmailAddress>
|SOAP/XML||<code><EmailAddress>'''''string'''''</EmailAddress></code>
|-
|XML||<EmailAddress>string</EmailAddress>
|}
|}




<h3 style="background-color:rgb240,240,240;">Mailbox Name</h3>
<h3 style="background-color:rgb(240,240,240);">Mailbox Name</h3>
:This is a string value listing the mailbox or user name portion of the email address (All characters preceding the "@" character).
:This is a string value listing the mailbox or user name portion of the email address (All characters preceding the "@" character).


Line 172: Line 158:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“MailboxName”:”string”
|JSON||<code>"MailboxName":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:MailboxName>?</urn:MailboxName>
|SOAP/XML||<code><MailboxName>'''''string'''''</MailboxName></code>
|-
|XML||<MailboxName>string</MailboxName>
|}
|}




<h3 style="background-color:rgb240,240,240;">Domain Name</h3>
<h3 style="background-color:rgb(240,240,240);">Domain Name</h3>
:This is a string value listing the domain name portion of the email address (All characters between the "@" and "." characters).
:This is a string value listing the domain name portion of the email address (All characters between the "@" and "." characters).


Line 188: Line 172:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“DomainName”:”string”
|JSON||<code>"DomainName":"'''''string'''''"</code>
|-
|SOAP||<urn:DomainName>?</urn:DomainName>
|-
|-
|XML||<DomainName>string</DomainName>
|SOAP/XML||<code><DomainName>'''''string'''''</DomainName></code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Top Level Domain</h3>
<h3 style="background-color:rgb(240,240,240);">Top Level Domain</h3>
:This is a string value listing the description associated with the top-level domain name of the email address.
:This is a string value listing the description associated with the top-level domain name of the email address.


Line 202: Line 184:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“Top Level Domain”:”string”
|JSON||<code>"Top Level Domain":"'''''string'''''"</code>
|-
|SOAP||<urn:Top Level Domain>?</urn:Top Level Domain>
|-
|-
|XML||<Top Level Domain>string</Top Level Domain>
|SOAP/XML||<code><Top Level Domain>'''''string'''''</Top Level Domain></code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Top Level Domain Name</h3>
<h3 style="background-color:rgb(240,240,240);">Top Level Domain Name</h3>
:This is a string value listing the top level domain name portion of the email address (All characters after the ".").
:This is a string value listing the top level domain name portion of the email address (All characters after the ".").


Line 218: Line 198:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“TopLevelDomainName”:”string”
|JSON||<code>"TopLevelDomainName":"'''''string'''''"</code>
|-
|-
|SOAP||<urn:TopLevelDomainName>?</urn:TopLevelDomainName>
|SOAP/XML||<code><TopLevelDomainName>'''''string'''''</TopLevelDomainName></code>
|-
|XML||<TopLevelDomainName>string</TopLevelDomainName>
|}
|}




<h3 style="background-color:rgb240,240,240;">Date Checked</h3>
<h3 style="background-color:rgb(240,240,240);">Date Checked</h3>
:This is a string value listing the date the email was last checked.
:This is a string value listing the date the email was last checked. DateChecked field returns a UTC, Unix Time (Epoch Time).


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON, JSONP||“DateChecked”:”string”
|JSON||<code>"DateChecked":"'''''string'''''"</code>
|-
|SOAP||<urn:DateChecked>?</urn:DateChecked>
|-
|-
|XML||<DateChecked>string</DateChecked>
|SOAP/XML||<code><DateChecked>'''''string'''''</DateChecked></code>
|}
|}




[[Category:Global Email]]
[[Category:Global Email V3]]
[[Category:Reference]]
[[Category:Reference]]

Latest revision as of 17:13, 23 May 2019

← Global Email V3

Global Email V3 Navigation
Introduction
Licensing
Input/Output
Request Fields
Response Fields
Examples
REST JSON
REST JSONP
REST XML
Batch SOAP
Batch XML
Result Codes
Result Code Use
Global Email V3 Result Codes
Sample Code



A response is the result of a request. This consists of returned results codes and parsed email elements.

Depending on the protocol used to make the request, the response will be in a certain protocol. Global Email supports the JSON, JSONP, SOAP, and XML protocols.


Field Names

This is a list of the response field names and their protocol naming conventions.

Field Name Level JSON/XML
Version Response (Base) Version
Transmission Reference TransmissionReference
Transmission Results TransmissionResults
Total Records TotalRecords
Record ID Record RecordID
Results Results
Email Address EmailAddress
Mailbox Name MailboxName
Domain Name DomainName
Top Level Domain TopLevelDomain
Top Level Domain Name TopLevelDomainName
Date Checked DateChecked


Response Elements

The following elements are the basic options for each request. These apply to the entire response, not the individual records.

Version

This is a string value that is the current revision number of Global Email.
Protocol Syntax
JSON "Version":"string"
SOAP/XML <Version>string</Version>


Transmission Reference

This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
Protocol Syntax
JSON "TransmissionReference":"string"
SOAP/XML <TransmissionReference>string</TransmissionReference>


Transmission Results

This is a string value that lists error codes from any errors caused by the most recent request as a whole.
For a complete list of error codes, see Global Email Result Codes.
Protocol Syntax
JSON "TransmissionResults":"string"
SOAP/XML <TransmissionResults>string</TransmissionResults>


Total Records

Displays the total number of records returned.
Protocol Syntax
JSON "TotalRecords":"string"
SOAP/XML <TotalRecords>string</TotalRecords>


Response Record Elements

JSON will only contain the Records element.

Protocol Definition
JSON Each record will be contained within [{}] under the Records element.
SOAP
XML

Each of the following elements are returned for each record in the Response Array.


Record ID

This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
Protocol Syntax
JSON "RecordID":"string"
SOAP/XML <RecordID>string</RecordID>


Results

This is a string value with comma delimited status, error codes, and change codes for the record.
For a complete list of codes, see Global Email Result Codes.
Protocol Syntax
JSON "Results":"string"
SOAP/XML <Results>string</Results>


Email Address

This is a string value listing the email address, including any corrections or changes made by Global Email.
Protocol Syntax
JSON "EmailAddress":"string"
SOAP/XML <EmailAddress>string</EmailAddress>


Mailbox Name

This is a string value listing the mailbox or user name portion of the email address (All characters preceding the "@" character).
With an example email of "sample@melissadata.com" the mailbox name would be "sample".
Protocol Syntax
JSON "MailboxName":"string"
SOAP/XML <MailboxName>string</MailboxName>


Domain Name

This is a string value listing the domain name portion of the email address (All characters between the "@" and "." characters).
With an example email of "sample@melissadata.com" the domain name would be "melissadata".
Protocol Syntax
JSON "DomainName":"string"
SOAP/XML <DomainName>string</DomainName>


Top Level Domain

This is a string value listing the description associated with the top-level domain name of the email address.
Protocol Syntax
JSON "Top Level Domain":"string"
SOAP/XML <Top Level Domain>string</Top Level Domain>


Top Level Domain Name

This is a string value listing the top level domain name portion of the email address (All characters after the ".").
With an example email of "sample@melissadata.com" the top level domain name would be "com".
Protocol Syntax
JSON "TopLevelDomainName":"string"
SOAP/XML <TopLevelDomainName>string</TopLevelDomainName>


Date Checked

This is a string value listing the date the email was last checked. DateChecked field returns a UTC, Unix Time (Epoch Time).
Protocol Syntax
JSON "DateChecked":"string"
SOAP/XML <DateChecked>string</DateChecked>
Retrieved from "http://wiki.melissadata.com/index.php?title=Global_Email_V3:Response&oldid=16510"