tomuz.rus.md

##Tomuz документация:##

• APIKEY должен пристутствовать в заголовке каждого запроса

  APIKEY: deadbeef
  Content-Type: application/x-www-form-urlencoded
  

• Каждый запрос должен исползовать метод POST

• есть 2 типа запросов:

  • Передавая кординату можно получить названия место
  • Передавая регулярную выражению можно получить названия место

• Чтобы передать кординату, в POST дата должен присутствовать "method=coordinate" и "lon" & "lat" e.g: method=coordinate&lon=41.2314&lat=69.2134

• Чтобы передать регулярку в POST дата нужно передать "method=pattern" и "pattern"

  e.g: method=pattern&pattern=ташкент

• Все ответы будут в JSON

• Рейтинг запросов можно узнать в ответе заголовка:

HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Sat, 06 Sep 2014 09:04:37 GMT
Content-Type: text/html; charset=utf8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/5.5.9-1ubuntu4.3
X-RateLimit-Limit: 		60
X-RateLimit-Remaining: 	59
X-RateLimit-Reset: 		3600

• Пример,Передавая кординату можно получить названия место :

 $curl -XPOST  -H 'APIKEY:deadbeef' -d "method=coordinate&lat=41.2939&lon=64.1233" localhost/tomuz/ -i

HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Sat, 06 Sep 2014 09:04:37 GMT
Content-Type: text/html; charset=utf8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/5.5.9-1ubuntu4.3
X-RateLimit-Limit: 		60
X-RateLimit-Remaining: 	59
X-RateLimit-Reset: 		3600

{
   "data":{
       "region":"\u0422\u0430\u0448\u043a\u0435\u043d\u0442",
       "city":"\u0433. \u0422\u0430\u0448\u043a\u0435\u043d\u0442",
       "district":"\u0411\u0435\u043a\u0442\u0435\u043c\u0438\u0440",
       "street":"\u041c\u0430\u0436\u043d\u0443\u043d\u0442\u043e\u043b",
       "block":"319",
       "subway":"",
       "lat":"41.243433",
       "lon":"69.392535",
       "distance":"5670"
   }
}

• Пример,Передавая регулярную выражению можно получить названия место

curl -H 'APIKEY:deadbeef' -XPOST -d 'method=pattern&pattern=чил%' localhost/tomuz/ -i

HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Sat, 06 Sep 2014 09:03:45 GMT
Content-Type: text/html; charset=utf8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/5.5.9-1ubuntu4.3
X-RateLimit-Limit: 		60
X-RateLimit-Remaining: 	59
X-RateLimit-Reset: 		3600

[{
   "region":"\u0422\u0430\u0448\u043a\u0435\u043d\u0442",
   "city":"\u0433. \u0422\u0430\u0448\u043a\u0435\u043d\u0442",
   "district":"\u0411\u0435\u043a\u0442\u0435\u043c\u0438\u0440",
   "street":"\u0421\u043e\u043b\u043d\u0435\u0447\u043d\u0430\u044f",
   "block":"13",
   "subway":"",
   "lat":"41.1721",
   "lon":"69.24121"
},{
   "region":"\u0422\u0430\u0448\u043a\u0435\u043d\u0442",
   "city":"\u0433. \u0422\u0430\u0448\u043a\u0435\u043d\u0442",
   "district":"\u0411\u0435\u043a\u0442\u0435\u043c\u0438\u0440",
   "street":"\u0421\u043e\u043b\u043d\u0435\u0447\u043d\u0430\u044f",
   "block":"12",
   "subway":"",
   "lat":"41.172227",
   "lon":"69.241426"
},{
   ...
},{
   ...
},{
   ...
},{
   ...
},{
   ...
},{
   ...
},{
   ...
},{
   ...
}]