xmpp.chapril.org-ejabberd/doc/http_post.md

# Managing pubsub nodes through HTTP Atompub #


## Configuration ##
	
These options will be used by the service to know how to build URLs. Using the previous configuration items the service should be accessed through `http://notify.push.bbc.co.uk:5280/pshb/<host>/<node>/`.

Also, in the ejabberd_http handler configuration, add the identified line.

	{5280, ejabberd_http, [
		 http_poll, 
		 web_admin,
		 {request_handlers, [{["pshb"], pshb_http}]} % this should be added
	]}

## Important notice ##

In the current version of the code, some security checks are not done :

 * read operations can all be done without authentication

 * node creation uses the default `all` access_createnode acl, not checking for the actual configuration.

## Usage example with cURL ##

### Getting the service document ###

No authentication necessary. All nodes are listed.

 curl -i http://host:port/pshb/domain/
	
### Getting items from a node ###

No authentication done, and all nodes are accessible.

 curl -i http://host:port/pshb/domain/node/


### Posting a new item ###

	curl -u jid:password -i -X POST -d @entry.atom http://post:port/pshb/domain/node 
	
User ability to post is based on node configuration.


### Creating a new node ###

An instant node can be created if server configuration allows:

	curl -X POST -u cstar@localhost:encore -d "" http://localhost:5280/pshb/localhost
	
or

	curl -X POST -u cstar@localhost:encore -d "<pubsub><create node='princely_musings'/></pubsub>" http://localhost:5280/pshb/localhost
	
configure element (as per XEP-60) can be passed in the pubsub body.
	
	$ cat createnode.xml
	<pubsub><create node='princely_musings' type='flat'/>
	<x xmlns='jabber:x:data' type='submit'>
	  <field var='FORM_TYPE' type='hidden'>
	    <value>http://jabber.org/protocol/pubsub#node_config</value>
	  </field>
	  <field var='pubsub#title'><value>Princely Musings (Atom)</value></field>
	  <field var='pubsub#max_payload_size'><value>1028</value></field>
	  <field var='pubsub#type'><value>Atom</value></field>
	</x>
	</pubsub>
	
	$ curl -X POST -u cstar@localhost:encore -d @createnode.xml http://localhost:5280/pshb/localhost
	
### Deleting a node ###

A node is deleted by: 

	curl -X DELETE -u cstar@localhost:encore http://localhost:5280/pshb/localhost/princely_musings