MatchUp Web Service:GetJobStatus: Difference between revisions
Jump to navigation
Jump to search
Created page with "{{MatchUpWebServiceNav |InputOutputCollapse= }} {{CustomTOC}} A request consists of a protocol to make a call to the service, detailing desired elements. Your License Key a..." |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 9: | Line 9: | ||
MatchUp Web Service supports the JSON and REST protocols to access the service. | MatchUp Web Service supports the JSON and REST protocols to access the service. | ||
{{HTTPHeader-MatchUp}} | |||
==Field Names== | ==Field Names== | ||
| Line 102: | Line 104: | ||
=GetJobStatusResponse= | ==GetJobStatusResponse== | ||
This will return the | This will return the current status of a submitted job. | ||
<h3 style="background-color:rgb(240,240,240);">EstimatedExecutionTime</h3> | <h3 style="background-color:rgb(240,240,240);">EstimatedExecutionTime</h3> | ||
:This is a string value containing the approximate processing time of the job. | :This is a string value containing the approximate processing time of the job. | ||
:<span style="color:red">'''Currently not implemented'''</span> | |||
:{| class="alternate01" | :{| class="alternate01" | ||
| Line 116: | Line 120: | ||
<h3 style="background-color:rgb(240,240,240);">Results</h3> | <h3 style="background-color:rgb(240,240,240);">Results</h3> | ||
:This is a string value containing the results of the [[# | :This is a string value containing the results of the [[#GetJobStatusRequest|GetJobStatusRequest]]. | ||
:{| class="alternate01" | :{| class="alternate01" | ||
Latest revision as of 17:07, 26 March 2021
| MatchUp Navigation | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
| ||||||||
| ||||||||
| ||||||||
| Sample Code |
A request consists of a protocol to make a call to the service, detailing desired elements. Your License Key and Job ID are required.
MatchUp Web Service supports the JSON and REST protocols to access the service.
Header
HTTP headers need to match the protocols and formats being used.
MatchUp requires the values of Content-Type and Accept.
Example JSON Request Header
{
"Content-Type": "application/json; charset=utf-8",
"Accept": "application/json"
}
Field Names
This is a list of the field names and their protocol naming conventions.
Request
| Field Name | REST | JSON |
|---|---|---|
| License Key | id | CustomerID |
| Job ID | job | JobID |
| Transmission Reference | t | TransmissionReference |
| Format | format | Format |
Response
| Field Name |
|---|
| EstimatedExecutionTime |
| PercentComplete |
| Results |
| TransmissionReference |
GetJobStatusRequest
This will query a submitted job's status.
License Key
- Required.
- This is a string value containing the License Key issued to the customer by Melissa for the MatchUp Web Service.
- If this element is absent, the Web Service will return an error. To receive a License Key, please contact your Melissa sales representative at 1-800-MELISSA.
Protocol Syntax JSON "CustomerID":"string"REST &id = string
Job ID
- Required.
- This is a string value with the Job ID returned by CreateJob.
Protocol Syntax JSON "JobID":"string"REST &job = string
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
Format
- Optional.
- Specify the desired output format (XML or JSON). Default is .
Protocol Syntax JSON "Format":"string"REST &format = string
GetJobStatusResponse
This will return the current status of a submitted job.
EstimatedExecutionTime
- This is a string value containing the approximate processing time of the job.
- Currently not implemented
Protocol Syntax JSON "EstimatedExecutionTime":"string"
Results
- This is a string value containing the results of the GetJobStatusRequest.
Protocol Syntax JSON "Results":"string"
TransmissionReference
- 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"