Hur använder jag denna API:n

Jag har aldrig tidigare jobbat med api:er och har nu fått ett antal uppgifter och är lite förvirrad hur jag ska använda dessa uppgifter. Någon mer rutinerad som kan förklara eller visa genom ett exempel hur jag ska jobba med datan:

HTTP requests
Example:

http://api.adress.com/partnerapi/se/companies/reviews?search_word=03 lalish;röningsg. 25 d hofors 81334;;0736838588;

Parts:

\* Host: <http://api.adress.com/>
\* Path: /partnerapi/se/companies/reviews
\* search_word: 03%20lalish;r%C3%B6ningsg.%2025%20d%20hofors%2081334;;0736838588;

search_word consists of four parts separated by semicolon:

1. Company name: 03 lalish;
2. Address {street address} {postarea} {postcode} Address with somewhat odd order of fields
3. Organisation number Organisation number
4. Phone number phone number without spaces or hyphen;

XML result

<?xml version="1.0" encoding="???"?>

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:e="http://api.adress.com/2010/Edada">

<title></title>

<id>http://api.adress.com/partnerapi/se/companies/reviews?search_word=03 lalish%3Br�ningsg. 25 d hofors 81334%3B%3B0736838588#2010-02-17T14%3A25%3A33.600Z\</id>

<link rel="alternate" type="text/html" href="http://api.adress.com" />

<link rel="self" type="application/atom+xml" href="http://api.adress.com/partnerapi/se/companies/reviews?search_word=03 lalish%3Br�ningsg. 25 d hofors 81334%3B%3B0736838588"/>

<updated>2010-02-17T14:25:33.600Z</updated>

<entry>

 \<title\>03 Lalish\</title\>

 \<id\>http://www.adress.se/omdome/407911/03%20Lalish#2010-02-17T14%3A25%3A33.600Z\</id\>

 \<link type="text/xml" href="http://www.adress.se/omdome/407911/03%20Lalish" /\>

 \<updated\>2010-02-17T14:25:33.601Z\</updated\>

 \<author\>\<name\>adress.se\</name\>\</author\>

 \<content\> \</content\>

 \<e:number_of_ratings\>1\</e:number_of_ratings\>

 \<e:average_rating\>1.0\</e:average_rating\>

 \<e:target_id\>407911\</e:target_id\>

 \<e:deep_link\>http://www.adress.se/omdome/407911/03%20Lalish\</e:deep_link\>

</entry>

</feed>

DTD

<!ELEMENT entry ( title, id, link, updated, author, content, e:number_of_ratings, e:average_rating, e:target_id, e:deep_link ) >

<!ELEMENT feed ( title, id, link+, updated, entry+ ) >

<!ELEMENT author ( name ) >

<!ELEMENT content EMPTY >

<!ELEMENT e:average_rating ( #PCDATA ) >

<!ELEMENT e:deep_link ( #PCDATA ) >

<!ELEMENT e:number_of_ratings ( #PCDATA ) >

<!ELEMENT e:target_id ( #PCDATA ) >

<!ELEMENT id ( #PCDATA ) >

<!ELEMENT link EMPTY >

<!ATTLIST link href CDATA #REQUIRED >

<!ATTLIST link rel NMTOKEN #IMPLIED >

<!ATTLIST link type CDATA #REQUIRED >

<!ELEMENT name ( #PCDATA ) >

<!ELEMENT title ( #PCDATA ) >

<!ELEMENT updated ( #PCDATA ) >