API DOCUMENTATION
- METHOD: uploadAndPost
- METHOD: upload
- Error codes
- Image Thumbnails
METHOD: http://wozpic.com/api/uploadAndPost
Use this method to upload an image to WozPic and to send it as a status update to Wozai.
Fields to post in
(post data should be formatted as multipart/form-data):
- media (required) - Binary image data
- username (required) - Wozai username
- password (required) - Wozai password
- message (optional) - Message to post to wozai. The URL of the image is automatically added.
Sample response:
<?xml version="1.0" encoding="UTF-8"?> <rsp status="ok"> <statusid>1111</statusid> <userid>11111</userid> <mediaid>abc123</mediaid> <mediaurl>http://wozpic.com/v/abc123</mediaurl> </rsp>
METHOD: http://wozpic.com/api/upload
Use this method if you only want to upload a photo to WozPic.
Fields to post in:
(post data should be formatted as multipart/form-data)
- media (required) - Binary image data
- username (required) - Wozai username
- password (required) - Wozai password
Sample response:
<?xml version="1.0" encoding="UTF-8"?> <rsp stat="ok">
<mediaid>abc123</mediaid> <mediaurl>http://wozpic.com/v/abc123</mediaurl> </rsp>
Sample error response:
<?xml version="1.0" encoding="UTF-8"?> <rsp stat="fail"> <err code="1001" msg="Invalid wozai username or password" /> </rsp>
Error codes and their descriptions:
1001 - Invalid wozai username or password
1002 - Image not found
1003 - Invalid image type
1004 - Image larger than 4MB
Use the following URL structure to add Twitpic thumbnails into your app:
http://wozpic.com/show/<size>/<image-id>
Size: mini or thumb
Image ID: this is the ID of the Wozpic photo
Example: http://wozpic.com/show/thumb/1e10q
*note: Wozpic Community Guidelines specify that if you use a Wozpic thumbnail in your app, the photo must link back to its original photo page or a link to the original photo page must be provided somewhere within context to the thumbnail
**note: this URL may forward to an ImageShake URL
|