30.07.2012 Views

Reference Guide

Reference Guide

Reference Guide

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Signing API Requests<br />

Importance of the Date Header<br />

Web API <strong>Reference</strong> <strong>Guide</strong><br />

The value of the Date HTTP header is used as part of the request signing process to enforce the<br />

temporary state of signed requests. For this reason, the system clock on the client and server sides must<br />

be synchronized, up to an allowed time skew of ±30 seconds.<br />

If the server receives an API request with a Date header value that represents more than 30 seconds of<br />

time difference (either before or after the server clock), the request will not be accepted.<br />

The X-Zend Signature HTTP Header<br />

In order to send authenticated API requests you are required to send the X-Zend-Signature HTTP header<br />

with each request. It must be in the following format:<br />

X-Zend-Signature: ; <br />

Where is replaced with the key name, and is replaced with the calculated<br />

request signature.<br />

There can be any number of whitespace characters before or after the separating semicolon.<br />

Example:<br />

X-Zend-Signature: Arch Stanton;<br />

a0f9b1d61e21e796d78dccdf1352f23cd328...<br />

Note:<br />

The signature is expected to be 64 characters long, and is cut here for readability purposes.<br />

339

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!