This document explains how to construct and submit a Feedback API call. It provides an overview of the formats and parameters you can use with the Feedback API.

Supported Request and Response Formats

The Feedback API supports the following request and response formats.

XML—the HTTP POST method supports the use of XML format requests. The response format for XML requests is also XML.
SOAP—the HTTP POST method supports the use of SOAP format requests. The response format for SOAP requests is also SOAP. SOAP versions 1.1 and 1.2 are both supported.

Call Structure

Each Feedback API call consists of the following elements:

Service Endpoint—all Feedback API requests must be sent to eBay's Production API Gateway (endpoint)
HTTP Headers—each Feedback API call requires some HTTP headers. For example, you must specify your user token in the X-EBAY-SOA-SECURITY-TOKEN header. Similarly, you must always specify the call name in the X-EBAY-SOA-OPERATION-NAME header.
Standard Input Fields—the Feedback API calls to not have standard input fields.
Call-specific Fields—some input fields, such as keywords or categoryId are specific to a particular API call

Service Endpoints

All Feedback API requests must be sent to the eBay Production API Gateway URL (endpoint): https://svcs.ebay.com/FeedbackService

The Feedback Service is not currently supported in the eBay Sandbox environment.

Standard HTTP Header Values

When you make a Feedback API call, you choose whether to specify a standard value in the HTTP header. The following table contains descriptions of standard Feedback API parameters and the corresponding headers:

Header Value

Required?

Description

CONTENT-TYPE

If you use this header, you must specify the content format exactly as shown, or your call may fail. The allowable values are:

XML	text/xml
SOAP12	application/soap+xml
SOAP11	text/xml (together with SOAPAction header being sent - value can be anything)

X-EBAY-SOA-MESSAGE-PROTOCOL

Conditionally

If you make a SOAP request, you must use this header to specify the protocol you are using. Allowable values are "SOAP11" for SOAP Version 1.1 and "SOAP12" for SOAP Version 1.2.

X-EBAY-SOA-OPERATION-NAME

Yes

The name of the call you are using (for example, createDSRSummaryByCategory or getDSRSummary).

X-EBAY-SOA-SECURITY-TOKEN

Yes

For authenticated services, this provides the Auth Token for the user upon whose behalf the call is made.

X-EBAY-SOA-SERVICE-NAME

The name of the eBay API you are using. Specify "FeedbackService" for all Feedback API calls.

X-EBAY-SOA-SERVICE-VERSION

The API version your application supports (e.g., 1.0.0).

Standard Input Values

The Feedback API calls to not have standard input fields.

Call-Specific Values

Refer to the Feedback API Call Reference for the input and output fields supported by the Feedback API calls.

HTTP Header Examples

The following example shows standard Feedback API headers for an HTTP POST call using XML:

X-EBAY-SOA-OPERATION-NAME: getDSRSummary
X-EBAY-SOA-SERVICE-VERSION: 1.0.0
X-EBAY-SOA-SECURITY-TOKEN: YourTokenHere
X-EBAY-SOA-SERVICE-NAME: FeedbackService

The following example shows standard Feedback API headers for an HTTP POST call. The X-EBAY-API-REQUEST-ENCODING header specifies XML for XML or SOAP input, and the example includes X-EBAY-SOA-MESSAGE-PROTOCOL: SOAP12 to specify you are using SOAP Version 1.2.

X-EBAY-SOA-OPERATION-NAME: getDSRSummary
X-EBAY-SOA-SERVICE-VERSION: 1.0.0
X-EBAY-SOA-SECURITY-TOKEN: YourTokenHere
X-EBAY-SOA-MESSAGE-PROTOCOL: SOAP12
X-EBAY-SOA-SERVICE-NAME: FeedbackService

Testing Overview

You can test calls using the Production environment (that is, using the https://svcs.ebay.com/FeedbackService? endpoint). For the Feedback API, the Production environment is preferred for testing, because the Production environment has pertinent data and the Feedback DSR calls do not alter item or user data.

The Feedback Service is not currently supported in the eBay Sandbox environment.

Schema Location

You can access a particular version of the Feedback schema using a URL with the following format, where VERSION is the version identifier of the release:

http://developer.ebay.com/webservices/feedback/VERSION/FeedbackService.wsdl

The version identifier is the version number of a particular schema (a release number)

For example, you can access version 1.0.0 of the WSDL version of the schema at the following URL:

http://developer.ebay.com/webservices/feedback/1.0.0/FeedbackService.wsdl

Alternatively, you can use the following link to download the latest WSDL for the Feedback API:

http://developer.ebay.com/webservices/feedback/latest/FeedbackService.wsdl

User-Contributed Notes

This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.

eBay Feedback API Making an API Call