API Summary

API Documentation

http://pownce.com/api/

Supported Media Types

JSON,XML

Authentication

HTTP Basic Authentication with username and password

HTTP Logs

Post A Message

Pownce offers two ways to send a message. Message-Only and Message-With-Link. Here are the details on both.

Message-Only

Post Message Response

REQUEST: **************
POST /2.0/send/message.xml?app_key=**************** HTTP/1.1
user-agent:venner-web/1.0b
Host: api.pownce.com
Accept: */*
Content-Length:53
Authorization: Basic ******************

note_to=public¬e_body=this is a test of venner

RESPONSE: **************
HTTP/1.0 200 OK
Date: Sat, 07 Jun 2008 02:30:57 GMT
Server: Apache/2.2.3 (Debian) mod_python/3.2.10 Python/2.4.4 PHP/5.2.0-8+etch9
Vary: Accept-Encoding
Content-Length: 1986
Connection: keep-alive
Content-Type: text/xml
Keep-Alive: timeout=30, max=100
	    	

Message-With-Link

Post Message-With-Link Response

REQUEST: **************
POST /2.0/send/link.xml?app_key=****************** HTTP/1.1
user-agent:venner-web/1.0b
Host: api.pownce.com
Accept: */*
Content-Length:119
Authorization: Basic *********************

note_to=public&url=http://farm1.static.flickr.com/171/430210693_b94f5d6edc_o.png¬e_body=there's too many of you!

RESPONSE: **************
HTTP/1.0 200 OK
Date: Sat, 07 Jun 2008 02:34:58 GMT
Server: Apache/2.2.3 (Debian) mod_python/3.2.10 Python/2.4.4 PHP/5.2.0-8+etch9
Vary: Accept-Encoding
Content-Length: 2087
Connection: keep-alive
Content-Type: text/xml
Keep-Alive: timeout=30, max=100
	      

Get Public Stream

Must be an anonymous call (no auth header)

Get Public Stream Response

REQUEST: **************
GET /2.0/note_lists.xml?app_key=****************** HTTP/1.1
user-agent:venner-web/1.0b
Host: api.pownce.com
Accept: */*

RESPONSE: **************
HTTP/1.0 200 OK
Date: Sat, 07 Jun 2008 02:40:39 GMT
Server: Apache/2.2.3 (Debian) mod_python/3.2.10 Python/2.4.4 PHP/5.2.0-8+etch9
Vary: Accept-Encoding
Content-Length: 40109
Connection: keep-alive
Content-Type: text/xml
Keep-Alive: timeout=30, max=100
	     

Get Filtered Stream (messages from user and friends)

Returns user's latest messages.

Get Filtered Stream Response

REQUEST: **************
GET /2.0/note_lists/mamund.xml?app_key=**************** HTTP/1.1
user-agent:venner-web/1.0b
Host: api.pownce.com
Accept: */*
Authorization: Basic ***************

RESPONSE: **************
HTTP/1.0 200 OK
Date: Sat, 07 Jun 2008 02:23:18 GMT
Server: Apache/2.2.3 (Debian) mod_python/3.2.10 Python/2.4.4 PHP/5.2.0-8+etch9
Vary: Accept-Encoding
Content-Length: 2184
Connection: keep-alive
Content-Type: text/xml
Keep-Alive: timeout=30, max=100
	     

Get Message Detail

Get Message Detail Response

REQUEST: **************
GET /2.0/notes/2381189.xml?app_key=****************** HTTP/1.1
user-agent:venner-web/1.0b
Host: api.pownce.com
Accept: */*
Authorization: Basic ****************

RESPONSE: **************
HTTP/1.0 200 OK
Date: Sat, 07 Jun 2008 02:27:12 GMT
Server: Apache/2.2.3 (Debian) mod_python/3.2.10 Python/2.4.4 PHP/5.2.0-8+etch9
Vary: Accept-Encoding
Content-Length: 1991
Connection: keep-alive
Content-Type: text/xml
Keep-Alive: timeout=30, max=100
	     

Get User Profile

Get User Profile Response

REQUEST: **************
GET /2.0/users/mamund.xml?app_key=***************** HTTP/1.1
user-agent:venner-web/1.0b
Host: api.pownce.com
Accept: */*
Authorization: Basic *******************

RESPONSE: **************
HTTP/1.0 200 OK
Date: Sat, 07 Jun 2008 02:28:17 GMT
Server: Apache/2.2.3 (Debian) mod_python/3.2.10 Python/2.4.4 PHP/5.2.0-8+etch9
Vary: Accept-Encoding
Content-Length: 1281
Connection: keep-alive
Content-Type: text/xml
Keep-Alive: timeout=30, max=100