API Document - img.azyobuzi.net
API Document

Endpoints

All APIs provide on http://img.azyobuzi.net/api/.

redirect, redirect.json

Redirects to the image.

Parameters

uri required: A URI which you want to redirect to.
size The size which you want. (Default: full)
Choose full, large, thumb or video.
use_https It will redirect to the URI which starts with "https://" when set to true. (Default: false)

Example

Request

GET http://img.azyobuzi.net/api/redirect?uri=http://f.hatena.ne.jp/azyobuzin/20120823110153&size=thumb

Response

HTTP/1.1 303 See Other
Location: http://cdn-ak.f.st-hatena.com/images/fotolife/a/azyobuzin/20120823/20120823110153_120.jpg

all_sizes.json

Returns the URIs of all sizes it can get in JSON format.

Parameters

uri required: A URI which you want to expand.

Example

Request

GET http://img.azyobuzi.net/api/all_sizes.json?uri=http://twitpic.com/af9ddv

Response

{
    "large": "http://twitpic.com/show/large/af9ddv",
    "large_https": "https://twitpic.com/show/large/af9ddv",
    "full": "http://twitpic.com/show/full/af9ddv",
    "full_https": "https://twitpic.com/show/full/af9ddv",
    "thumb": "http://twitpic.com/show/thumb/af9ddv",
    "thumb_https": "https://twitpic.com/show/thumb/af9ddv",
    "video": null,
    "video_https": null,
    "service": "Twitpic"
}

regex.json

Returns the service names it supports and regex patterns of their URI in JSON format. The patterns are made for "Ignore Case"

Error Codes and Responses

Returns JSON like following when occurs errors:

{
  "error": {
    "message": "\"uri\" parameter you requested is not supported.",
    "code": 4002,
    "exception": null
  }
}

Status codes and error codes means following:

Error Code Status Code Reason
4001 400 This request was not specified "uri" parameter.
4002 400 It does not support your "uri" parameter.
4003 400 Your "size" parameter was invalid.
4041 404 This request did not select API. This error occurs when you access the root directly, like "http://img.azyobuzi.net/api/".
4042 404 The URI you requested does not exist.
4043 404 Tried expand the URI, but it could not find the picture or video.
4044 404 Tried expand the URI, but it was not a picture or video
4045 404 In "redirect", specified size=video, the URI you requested was not a video.
4051 405 This request is not "GET" or "HEAD" method.
5000 500 Unknown error was ocurred. img.azyobuzi.net may have a bug.

Terms

We does not guarantee that the value this service returns is always accurate. And even if any damages occured in using this service, we do not take the consequences.

We can change the resources and stop this service without notifying. And you must not put a lot of loads to the server.