Webservice Interface
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Get Tag By Name
Returns all Tags having the input parameter name. [
Test]
GET /api/xtm/tag/string HTTP/1.1
Host: www.fuzzzy.com
Get Tag By Id
Returns complete data for a single Tag. [
Test]
GET /api/xtm/tag/integer HTTP/1.1
Host: www.fuzzzy.com
Get Tag By Subject Identifier
Returns complete data for a single Tag. [
Test]
GET /api/xtm/GetTagByPSI/?psi=string HTTP/1.1
Host: www.fuzzzy.com
Sample XTM 2.0 Response
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8" ?>
<topicMap version="2.0" xmlns="http://www.topicmaps.org/xtm/">
<topic id="tag3053">
<subjectLocator href="http://www.fuzzzy.com/tag/3053" />
<instanceOf>
<topicRef href="#topictypeTag" />
</instanceOf>
<name>
<value>Roy Lachica</value>
</name>
<occurrence>
<type>
<topicRef href="#occTypeDescr" />
</type>
<resourceData>the fuzzzy guy </resourceData>
</occurrence>
<occurrence>
<type>
<topicRef href="#occTypeDateCreated" />
</type>
<resourceData>2007-02-26T14:55:10.0970000</resourceData>
</occurrence>
</topic>
<association id="assoc139979">
<type>
<topicRef href="#assocTypeIs" />
</type>
<role>
<type>
<topicRef href="#roleType2775" />
</type>
<topicRef href="#tag127480" />
</role>
<role>
<type>
<topicRef href="#roleType2775" />
</type>
<topicRef href="#tag3053" />
</role>
</association>
<association id="assoc3056">
<type>
<topicRef href="#assocTypeIs" />
</type>
<role>
<type>
<topicRef href="#roleType2775" />
</type>
<topicRef href="#tag3050" />
</role>
<role>
<type>
<topicRef href="#roleType2775" />
</type>
<topicRef href="#tag3053" />
</role>
</association>
<association id="assoc3059">
<type>
<topicRef href="#assocTypeCreated_by" />
</type>
<role>
<type>
<topicRef href="#roleType1425" />
</type>
<topicRef href="#tag2544" />
</role>
<role>
<type>
<topicRef href="#roleType1427" />
</type>
<topicRef href="#tag3053" />
</role>
</association>
<association id="assoc_tag_creator_3053_1">
<type>
<topicRef href="#assocTypeCreatedBy" />
</type>
<role>
<type>
<topicRef href="#roleTypeCreatedByUser" />
</type>
<topicRef href="#tag3053" />
</role>
<role>
<type>
<topicRef href="#roleTypeHavingCreatedTag" />
</type>
<topicRef href="#user1" />
</role>
</association>
<association id="assocTagLink0">
<type>
<topicRef href="#assocTypeIsAbout" />
</type>
<role>
<type>
<topicRef href="#roleType1" />
</type>
<topicRef href="#tag3053" />
</role>
<role>
<type>
<topicRef href="#roleType2" />
</type>
<topicRef href="#bookmark151" />
</role>
</association>
<association id="assocTagLink3">
<type>
<topicRef href="#assocTypeIsAbout" />
</type>
<role>
<type>
<topicRef href="#roleType4" />
</type>
<topicRef href="#tag3053" />
</role>
<role>
<type>
<topicRef href="#roleType5" />
</type>
<topicRef href="#bookmark853" />
</role>
</association>
<association id="assocTagLink6">
<type>
<topicRef href="#assocTypeIsAbout" />
</type>
<role>
<type>
<topicRef href="#roleType7" />
</type>
<topicRef href="#tag3053" />
</role>
<role>
<type>
<topicRef href="#roleType8" />
</type>
<topicRef href="#bookmark2287" />
</role>
</association>
<association id="assocTagLink9">
<type>
<topicRef href="#assocTypeIsAbout" />
</type>
<role>
<type>
<topicRef href="#roleType10" />
</type>
<topicRef href="#tag3053" />
</role>
<role>
<type>
<topicRef href="#roleType11" />
</type>
<topicRef href="#bookmark5347" />
</role>
</association>
<association id="assocTagLink12">
<type>
<topicRef href="#assocTypeIsAbout" />
</type>
<role>
<type>
<topicRef href="#roleType13" />
</type>
<topicRef href="#tag3053" />
</role>
<role>
<type>
<topicRef href="#roleType14" />
</type>
<topicRef href="#bookmark5348" />
</role>
</association>
<topic id="tag127480">
<subjectLocator href="http://www.fuzzzy.com/tag/127480" />
<instanceOf>
<topicRef href="#topictypeTag" />
</instanceOf>
<name>
<value>Programmer</value>
</name>
</topic>
<topic id="tag3050">
<subjectLocator href="http://www.fuzzzy.com/tag/3050" />
<instanceOf>
<topicRef href="#topictypeTag" />
</instanceOf>
<name>
<value>sexy</value>
</name>
</topic>
<topic id="tag2544">
<subjectLocator href="http://www.fuzzzy.com/tag/2544" />
<instanceOf>
<topicRef href="#topictypeTag" />
</instanceOf>
<name>
<value>Fuzzzy</value>
</name>
</topic>
<topic id="user1">
<subjectLocator href="http://www.fuzzzy.com/user/1" />
<instanceOf>
<topicRef href="http://xmlns.com/foaf/0.1/Person" />
</instanceOf>
<name>
<value>roylac</value>
</name>
<occurrence>
<type>
<topicRef href="#occTypeBio" />
</type>
<resourceData>I am the creator of this site and I'am also interested in knowledge and holism.</resourceData>
</occurrence>
<occurrence>
<type>
<topicRef href="#occTypeMemberSince" />
</type>
<resourceData>2006-11-02T00:00:00.0000000</resourceData>
</occurrence>
<occurrence>
<type>
<topicRef href="#occTypeThumbnail" />
</type>
<resourceData>http://www.fuzzzy.com/images/avatars/a1.jpg</resourceData>
</occurrence>
<occurrence>
<type>
<topicRef href="#occTypeFirstname" />
</type>
<resourceData>Roy</resourceData>
</occurrence>
<occurrence>
<type>
<topicRef href="#occTypeLastname" />
</type>
<resourceData>Lachica</resourceData>
</occurrence>
<occurrence>
<type>
<topicRef href="#occTypeTwitterId" />
</type>
<resourceData>Lachica</resourceData>
</occurrence>
</topic>
<topic id="topictypeTag">
<subjectLocator href="http://purl.org/dc/elements/1.1/subject" />
<name>
<value>Tag</value>
</name>
</topic>
<topic id="occTypeDescr">
<subjectLocator href="http://purl.org/dc/elements/1.1/description" />
<name>
<value>Description</value>
</name>
</topic>
<topic id="occTypeDateCreated">
<subjectLocator href="http://purl.org/dc/elements/1.1/date" />
<name>
<value>Date created</value>
</name>
</topic>
<topic id="assocType139980">
<subjectLocator href="http://www.fuzzzy.com/assoctypes/is" />
<name>
<value>Is</value>
</name>
</topic>
<topic id="roleType2775">
<subjectLocator href="http://www.fuzzzy.com/roletypes/is" />
<name>
<value>Is</value>
</name>
</topic>
<topic id="assocType139979">
<subjectLocator href="http://www.fuzzzy.com/assoctypes/is" />
<name>
<value>Is</value>
</name>
</topic>
<topic id="assocType3056">
<subjectLocator href="http://www.fuzzzy.com/assoctypes/is" />
<name>
<value>Is</value>
</name>
</topic>
<topic id="assocType3059">
<subjectLocator href="http://purl.org/dc/elements/1.1/creator" />
<name>
<value>Has created</value>
</name>
</topic>
<topic id="roleType1425">
<subjectLocator href="http://www.fuzzzy.com/roletypes/is_created_by" />
<name>
<value>Is created by</value>
</name>
</topic>
<topic id="roleType1427">
<subjectLocator href="http://www.fuzzzy.com/roletypes/has_created" />
<name>
<value>Has created</value>
</name>
</topic>
<topic id="assocTypeCreatedBy">
<subjectLocator href="http://www.fuzzzy.com/metatypes/assocTypes/createdBy" />
<name>
<value>Created by</value>
</name>
</topic>
<topic id="roleTypeCreatedByUser">
<subjectLocator href="http://www.fuzzzy.com/metatypes/roleTypes/isCreatedBy" />
<name>
<value>Is created by</value>
</name>
</topic>
<topic id="roleTypeHavingCreatedTag">
<subjectLocator href="http://www.fuzzzy.com/metatypes/roleTypes/hasCreated" />
<name>
<value>Has created</value>
</name>
</topic>
<topic id="assocTypeIsAbout">
<subjectLocator href="http://www.fuzzzy.com/metatypes/assocTypes/tagging/taggingCategorization" />
<name>
<value>Resource is about</value>
</name>
</topic>
<topic id="roleType1">
<subjectLocator href="http://www.fuzzzy.com/metatypes/roleTypes/bookmarkCategorization/tagging/categoryOfInformationFoundAt" />
<name>
<value>Is the tag of resource</value>
</name>
</topic>
<topic id="roleType2">
<subjectLocator href="http://www.fuzzzy.com/metatypes/roleTypes/bookmarkCategorization/tagging/isAbout" />
<name>
<value>Is about</value>
</name>
</topic>
<topic id="occTypeMemberSince">
<subjectLocator href="http://www.fuzzzy.com/metatypes/memberSince" />
<name>
<value>Member since</value>
</name>
</topic>
<topic id="occTypeThumbnail">
<subjectLocator href="http://xmlns.com/foaf/0.1/depiction" />
<name>
<value>Thumbnail</value>
</name>
</topic>
<topic id="occTypeFirstname">
<subjectLocator href="http://xmlns.com/foaf/0.1/firstName" />
<name>
<value>First name</value>
</name>
</topic>
<topic id="occTypeLastname">
<subjectLocator href="http://xmlns.com/foaf/0.1/lastName" />
<name>
<value>Last name</value>
</name>
</topic>
<topic id="occTypeTwitterId">
<subjectLocator href="http://www.fuzzzy.com/metatypes/twitterId" />
<name>
<value>Twitter Id</value>
</name>
</topic>
</topicMap>