Location: PHPKode > scripts > TwitPic API for PHP > meltingice-TwitPic-API-for-PHP/api/api.xml
<?xml version="1.0" encoding="UTF-8"?>

<!--
TwitPic API for PHP
Copyright 2010 Ryan LeFevre - @meltingice

Licensed under the New BSD License, more info in LICENSE file
included with this software.

Source code is hosted at http://github.com/meltingice/TwitPic-API-for-PHP

##########################################################################

This file is a direct mapping of the TwitPic REST API, which
is documented here: http://dev.twitpic.com/docs/

The implementation and struction is inspired by the Twitter_Services
PEAR package available here: http://pear.php.net/packages/Services_Twitter
-->

<api>

	<!-- Media Resources -->
	<category name="media">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="id" type="short_id" required="true"/>
			<param name="page" type="integer" required="false"/>
		</endpoint>
	</category>
	
	<!-- User Resources -->
	<category name="users">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="username" type="username" required="true"/>
		</endpoint>
	</category>
	
	<!-- Comment Resources -->
	<category name="comments">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="media_id" type="short_id" required="true"/>
			<param name="page" type="integer" required="true"/>
		</endpoint>
		<endpoint name="create" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="media_id" type="short_id" required="true"/>
			<param name="message" type="string" required="true"/>
		</endpoint>
		<endpoint name="delete" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="comment_id" type="integer" required="true"/>
		</endpoint>
	</category>
	
	<!-- Place Resources -->
	<category name="place">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="id" type="string" required="true"/>
			<param name="user" type="username" required="false"/>
		</endpoint>
	</category>
	<category name="places">
		<endpoint name="show" method="GET">
			<formats>xml,json></formats>
			<param name="user" type="username" required="true"/>
		</endpoint>
	</category>
	
	<!-- Face Tagging Resources -->
	<category name="faces">
		<endpoint name="show" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="user" type="username" required="true"/>
		</endpoint>
		<endpoint name="create" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="media_id" type="short_id" required="true"/>
			<param name="top_coord" type="integer" required="true"/>
			<param name="left_coord" type="integer" required="true"/>
			<param name="name" type="string" required="false"/>
			<param name="username" type="username" required="false"/>
		</endpoint>
		<endpoint name="edit" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="tag_id" type="integer" required="true"/>
			<param name="top_coord" type="integer" required="false"/>
			<param name="left_coord" type="integer" required="false"/>
			<param name="name" type="string" required="false"/>
			<param name="username" type="username" required="false"/>
		</endpoint>
		<endpoint name="delete" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="tag_id" type="integer" required="true"/>
		</endpoint>
	</category>
	
	<!-- Event Resources -->
	<category name="events">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="user" type="string" required="true"/>
		</endpoint>
	</category>
	<category name="event">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="id" type="string" required="true"/>
		</endpoint>
		<endpoint name="create" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="name" type="string" required="true"/>
			<param name="description" type="string" required="false"/>
			<param name="trigger" type="hashtag" required="false"/>
		</endpoint>
		<endpoint name="delete" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="event_id" type="integer" required="true"/>
		</endpoint>
		<endpoint name="add" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="media_id" type="integer" required="true"/>
			<param name="event_id" type="integer" required="true"/>
		</endpoint>
		<endpoint name="remove" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="event_id" type="integer" required="true"/>
			<param name="media_id" type="integer" required="true"/>
		</endpoint>
	</category>
	
	<!-- Tagging Resources -->
	<category name="tags">
		<endpoint name="show" method="GET">
			<formats>xml,json</formats>
			<param name="tag" type="hashtag" required="true"/>
		</endpoint>
		<endpoint name="create" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="media_id" type="string" required="true"/>
			<param name="tags" type="string" required="true"/>
		</endpoint>
		<endpoint name="delete" method="POST" auth_required="true">
			<formats>xml,json</formats>
			<param name="media_id" type="short_id" required="true"/>
			<param name="tag_id" type="integer" required="true"/>
		</endpoint>
	</category>
	
</api>
Return current item: TwitPic API for PHP