Chapter 3. Yahoo! Messenger Display Image API

Getting Started

The following sections will help you to get familiar with the Yahoo! Messenger Display Image API.

Basic Guidelines

  1. All APIs require Yahoo credentials

Yahoo! Credentials

The Yahoo! Messenger API accepts standard OAuth credentials passed through the HTTP Authorization header. The API also allows usage of the PLAINTEXT OAuth signature method when submitting credentials.

Best Practices

  • For image fetches, it is preferred that clients use the HEAD operations to fetch only the image URLs. Once the image URL is obtained, clients can go directly to the image source for download, instead of having this service proxy the fetch for you.
  • For image fetches, it is preferred that clients do all image re-formatting on the client side, rather than use the format, height, or width parameters to re-format on the server side.

Servers

  • Production: displayimage.messenger.yahooapis.com

Supported Content Types

  1. image/jpg
  2. image/gif
  3. image/png

Supported Networks

  • yahoo

Error Codes

The following table lists the specific error definitions for the Yahoo! Messenger Display Image API.

Error Codes Error Codes Definitions
1002 Invalid URI parameter
1003 Credentials validation failed
1007 Image processing failed
1008 File size exceeds maximum limit
1009 Content type not valid
(default) Internal Server Error

The following table lists the possible error codes for each HTTP status.

HTTP Code Application Error Codes
200, 201 -
400 1002
403 1003
404 1001
500 All other error codes
Sample

Table of Contents