A SERVICE OF

logo

Chapter 1: Using the REST API 20
Transforming Data Returned
Version 3.7
After you have tested your program’s ability to handle output, you can use your program in
production to transform output or you can enable server-side processing. Server-side processing
uses your XSL files to format the output for you. For more information on server-side processing that
uses your XSL files, see “Transforming Data Returned” on page 20.
Transforming Data Returned
Using the XML-to-HTML Transform tool, you can enable processing that transforms the XML
returned by the REST API. This server-side processing is done using XSL files that you upload. You
access your uploaded XSL files using a link on the REST Developer Center page (
http://
developer.ebay.com/developercenter/rest
), on the eBay Developers Program site.
You can use your uploaded XSL files to efficiently transform data returned into formats that meet
your needs and the needs of your users. Server-side transformation of data returned in the REST API
can remove the need for you to manage formatting and other transformations of data returned, thus
providing you with enhanced flexibility and lower costs.
To enable server-side processing of your uploaded XSL files, you must have production keys and at
least one production-certified application. For more information, see “Using the REST API in
Production” on page 8. Server-side processing of uploaded XSL files is not available in the Sandbox
environment.
Calls to the eBay REST API that utilize server-side processing are made using the following URL:
http://www.ebayxslt.com/ws/web/apixslt?
If you make a call to the eBay REST API that utilizes server-side processing, and omit the
UnifiedInput parameter, the data returned is in unified schema format whether or not you add the
Schema=1 setting. For information on the Schema=1 setting, see “Basic REST Input Parameters” on
page 3.
This section of the REST API Guide contains the following subsections:
“Uploading and Using XSL Files” on page 20
“Viewing, Renaming, and Deleting XSL Files” on page 21
Uploading and Using XSL Files
After you have production keys and at least one production-certified application, you can upload
XSL files to the XML-to-HTML Transform tool. The XML-to-HTML Transform tool is accessible from
a link on the REST Developer Center page (
http://developer.ebay.com/developercenter/rest).
You use the XML-to-HTML Transform tool by entering a production Developer Id (DevId) key. The
DevId key is the first key of the DevId/AppId/CertId set of keys. It is an alphanumberic string. After
you enter your DevId, you can upload the XSL files that eBay servers will use to transform data
returned by the REST API. The eBay servers will use the Saxon 6.5.2 processor for transformations.
Each file you upload is associated with a production-certified application. A maximum of 20 XSL
files can be associated with one production-certified application.