If you have any question left, please drop a note with the discussion link of this page.

Little tutorial for POSTER and the zanox webservices

From Wiki.zanox.com

Jump to: navigation, search

Contents

Poster and the zanox webservices

Poster is a developer tool for interacting with web services and other web resources that lets you make HTTP requests, set the entity body, and content type. This allows you to interact with web services and inspect the results.

Installation

Open your Firefox-Browser an go to https://addons.mozilla.org/de/firefox/addon/2691. Then download and install the plugin. After installation you have to restart Firefox.

Getting Started

Poster can be used in the sidebar or in a separate window.

To use Poster in the Firefox sidebar go to View>Sidebar>Poster:

Poster as sidebar in Firefox

To use Poster in a separate window have a look at the status-line of your firefox-browser window. There you should see a little yellow icon with a P on it Poster icon. Click on it and Poster opens in a window:

Poster in an external window

Make a request without a signature

As an example we take the REST ressource "/xml/products?q=searchforsometext":

In the field URL type: http://api.zanox.com/xml/products?q=wii+fit (wii+fit is the search query in this case, change if you like to search for something else)

The field FILE and User Auth can be leaved empty.

Content-Type should be left to the defaulted: text/xml

Under Actions select GET in the first dropdown.

Make a request without a signature

Now we have to set some Headers:

Select Headers in the second dropdown an click on the go-Button next to it. A new window appears where you can enter the following information:

Name Value Notes
Date Tue, 14 Oct 2008 10:13:59 GMT Note the format of the date and the constrained time span during whicht the date is valid
Authorization ZXWS 3510505495993E832BDB This is ZXWS followed by a space and your Application ID
Host api.zanox.com Fixed value for all REST requests

Enter request headers

Now go back to the main window of poster and click on the GO button next to the first dropdown where you have selected GET previously.

A new window will open and present the request result and additional information to you:

Result and additional information

Make a request with a signature

Requests which require a signature are done almost the same. The only difference is, that you need to add your signature to the Authorization Header Information.

If you have not build an application yet, which computes your signature try out our signature tool for REST requests

Now we show you an example using the /xml/adspaces ressource and poster:

Fill in the main poster window like this:

In the field URL type: http://api.zanox.com/xml/adspaces

The field FILE and User Auth can be leaved empty.

Content-Type should be left to the defaulted: text/xml

Under Actions select GET in the first dropdown.

Make a request with a signature

Now set the headers with signature:

Setting the headers with signature

Now go back to the main window of poster and click on the GO button next to the first dropdown where you have selected GET previously.

A new window will open and present the request result and additional information to you:

Request result and additional information

That's it!

Personal tools