Wozai

Wozai API

  • Getting Started
    • Compatible with Twitter API Documentation
    • API Root
    • Authentication
    • Rate Limiting
    • Examples
  • Search API Methods
    • Search
    • Notes
  • REST API Methods
    • Timeline Methods
    • Status Methods
    • User Methods
    • Direct Message Methods
    • Friendship Methods
    • Social Graph methods
    • Account Methods
    • Favorite Methods
    • Block Methods
  • Partners
    • wozpic.com

Getting Started

Compatible with Twitter API Documentation

Wozai's API is designed so that applications that already work with Twitter, will also work with Wozai.  The methods that are implemented (see: Search API and REST API Methods), mirrors and functions similarly to those of Twitter. The Official Twitter API Wiki http://apiwiki.twitter.com/Twitter-API-Documentation is a useful source for additional detail and examples

API Root

The API root for Wozai is at: http://api.wozai.cc

For example:

  • Twitter would use: http://twitter.com/statuses/public_timeline.format
  • Wozai would use: http://api.wozai.cc/statuses/public_timeline.format


Authentication

Some methods require authentication, please check them before using.

Rate Limiting

Wozai currently does not enforce a rate limit


Examples

Take /statuses/public_timeline for example, originally use http://twitter.com/statuses/public_timeline.xml to get the 20 most recent public statuses in XML format. In Wozai, you can use http://api.wozai.cc/statuses/public_timeline.xml to get the most 20 recent public statuses.

<?xml version="1.0" encoding="UTF-8"?>
<statuses>
<status>
<created_at>Mon Sep 07 10:24:46 +0000 2009</created_at>
<id>63897</id>
<text>@Channy 可以跟隨http://nel.ly/pROxhq 他</text>
<source />
<truncated>false</truncated>
<in_reply_to_status_id />
<in_reply_to_user_id />
<favorited>false</favorited>
<in_reply_to_screen_name />
<user>
<id>26</id>
<name>甲賀</name>
<screen_name>turbo</screen_name>
<location>臺北市,中正區</location>
<description>http://tw.streetvoice.com/music/embedMusic.mp3</description>
<profile_image_url>http://s3.amazonaws.com/wozai/avatar/turbo_thumbnail_200909050622.jpg</profile_image_url>
<url>http://turbolin.blogspot.com/</url>
<protected>false</protected>
<followers_count>720</followers_count>
<profile_background_color />
<profile_text_color />
<profile_link_color />
<profile_sidebar_fill_color />
<profile_sidebar_border_color />
<friends_count>503</friends_count>
<created_at>Sat Jun 27 14:40:35 +0000 2009</created_at>
<favourites_count>160</favourites_count>
<utc_offset />
<time_zone />
<profile_background_image_url>http://s3.amazonaws.com/wozai/user_bg/turbo_200909020652.jpg</profile_background_image_url>
<profile_background_title>false</profile_background_title>
<statuses_count>1033</statuses_count>
<notifications>false</notifications>
<following>false</following>
<verified>true</verified>
</user>
</status>

... truncated ...
</statuses>

Search API Methods

Wozai's Search API Methods are implemented similarly to Twitters. Additional detail regarding Twitter’s Search API Methods can be found at: http://apiwiki.twitter.com/Twitter-API-Documentation

  • search
  • Notes:
    • Supports ATOM and JSON
    • The following parameters are not supported now: lang, locale, geocode, show_user
    • The Boolean operators (OR, negative) are not supported now.

REST API Methods

Wozai's REST API Methods are implemented similarly to Twitters. Additional detail regarding Twitter's REST API Methods can be found at: http://apiwiki.twitter.com/Twitter-API-Documentation

Timeline Methods

  • statuses/public_timeline
  • statuses/friends_timeline
  • statuses/user_timeline
  • statuses/mentions

Status Methods

  • statuses/show
  • statuses/update
  • statuses/destroy

User Methods

  • users/show
  • statuses/friends
  • statuses/followers

Direct Message Methods

  • direct_messages
  • direct_messages/sent
  • direct_messages/new
  • direct_messages/destroy

Friendship Methods

  • friendships/create
  • friendships/destroy
  • friendships/exists
  • friendships/show

Social Graph Methods

  • friends/ids
  • followers/ids

Account Methods

  • account/verify_credentials
  • account/update_profile_image
  • account/update_profile_background_image
  • account/update_profile

Favorite Methods

  • Favorites
  • favorites/create
  • favorites/destroy

Block Methods

  • blocks/create
  • blocks/destroy
  • blocks/exists
  • blocks/blocking
  • blocks/blocking/ids

Partners

  1. wozpic.com – wozpic allows you to share photos on Wozai. WozPic’s API can be found at http://wozpic.com/api/doc