API

LocationBox API

Social Event List

(powered by dakick.com services)

Social Event Service lists social events with their locations based on criterias which you can find below.

A Social Event List request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SocialEventList&Typ=output_format&Id=social_event_id


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (SocialEventList)
Typ: Response format. (XML or JSON)
Id: ID of SocialEvent

Response Parameters


XML Response

Social Event List response returns in XML format when the Typ parameter is set as "XML".

Below is an example for a Social Event List request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SocialEventList&Typ=XML

The response will be as following:

<response>
 <transactionid>LBS_375259130</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
 <items>
  <socialevent>
   <id>7949980</id>
   <name>Geçmiþten Günümüze Bebek Ürünleri Sergisi</name>
   <description>"Geçmiþten Günümüze Bebek Ürünleri Sergisi" 10-25 Kasým tarihleri arasýnda Palladium AVM'de.</description>
   <category>140</category>
   <location>Palladium AVM</location>
   <startdate>2012-11-10 10:00:00</startdate>
   <enddate>2012-11-25 22:00:00</enddate>
   <timezone>Istanbul</timezone>
   <latitude>40.9862</latitude>
   <longitude>29.1007</longitude>
  </socialevent>
  <socialevent>
   <id>7869738</id>
   <name>Memduh Kuzay Resim Sergisi</name>
   <description>Türkiye’nin yanýsýra Amerika ve Almanya’da sürdüren Memduh Kuzay’ýn Tolga Eti SanatEvi’nin sanat anlayýþýna paralel gerçekleþtirdiði resim sergisi 3 Kasým – 8 Aralýk 2012 tarihleri arasýnda izlenebilir.</description>
   <category>140</category>
   <location>Tolga Eti Sanatevi</location>
   <startdate>2012-11-03 10:00:00</startdate>
   <enddate>2012-12-08 19:00:00</enddate>
   <timezone>Istanbul</timezone>
   <latitude>40.9802</latitude>
   <longitude>29.0823</longitude>
   <distance>3629</distance>
  </socialevent>

   ...

  <socialevent>
   <id>7853952</id>
   <name>Boðaziçi Caz Korosu Konseri</name>
   <description>Yaklaþýk 35 kiþilik kadrosuyla çaðdaþ müzikten caza, hatta çok sesli türkü düzenlemelerine kadar uzanan çok geniþ bir repertuvara sahip olan Boðaziçi Caz Korosu zengin bir programla 19 Kasým akþamý Süreyya Operasý’nda.</description>
   <category>128</category>
   <location>Süreyya Operasý</location>
   <startdate>2012-11-19 20:00:00</startdate>
   <enddate>2012-11-19 22:00:00</enddate>
   <timezone>Istanbul</timezone>
   <latitude>40.9881</latitude>
   <longitude>29.0286</longitude>
   <distance>6481</distance>
  </socialevent>
  </items>
</response>

JSON Response

Social Event List response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for a Social Event List request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SocialEventList&Typ=JSON


The response will be as following:


{ "transactionid": "LBS_1953422", "status": 0, "items": [ { "id": 7949980, "name": "Geçmiþten Günümüze Bebek Ürünleri Sergisi", "description": "Geçmiþten Günümüze Bebek Ürünleri Sergisi 10-25 Kasým tarihleri arasýnda Palladium AVM`de.", "category": 140, "location": "Palladium AVM", "startdate": "2012-11-10 10:00:00", "enddate": "2012-11-25 22:00:00", "timezone": "Istanbul", "latitude": 40.9862, "longitude": 29.1007 }, { "id": 7869738, "name": "Memduh Kuzay Resim Sergisi", "description": "Türkiye’nin yanýsýra Amerika ve Almanya’da sürdüren Memduh Kuzay’ýn Tolga Eti SanatEvi’nin sanat anlayýþýna paralel gerçekleþtirdiði resim sergisi 3 Kasým – 8 Aralýk 2012 tarihleri arasýnda izlenebilir.Memduh Kuzay’ýn resimleri yurt dýþýnda da sergilenmekte ve koleksiyonlarda yer almaktadýr.", "category": 140, "location": "Tolga Eti Sanatevi", "startdate": "2012-11-03 10:00:00", "enddate": "2012-12-08 19:00:00", "timezone": "Istanbul", "latitude": 40.9802, "longitude": 29.0823 }, ... { "id": 7853952, "name": "Boðaziçi Caz Korosu Konseri", "description": "Yaklaþýk 35 kiþilik kadrosuyla çaðdaþ müzikten caza, hatta çok sesli türkü düzenlemelerine kadar uzanan çok geniþ bir repertuvara sahip olan Boðaziçi Caz Korosu zengin bir programla 19 Kasým akþamý Süreyya Operasý’nda.", "category": 128, "location": "Süreyya Operasý", "startdate": "2012-11-19 20:00:00", "enddate": "2012-11-19 22:00:00", "timezone": "Istanbul", "latitude": 40.9881, "longitude": 29.0286 } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)
result:

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

Error Codes
10001 Error processing your request. Please try again soon.
Cmd parameter is misspelled/not found.
10011 Error processing your request. Please check the Cmd parameter.
Cmd is not specified.
10012 Error processing your request. Please check the Key parameter.
Key is not specified.
10013 Error processing your request. Please check the Key parameter.
Key is invalid.
20012 No data found.