从零开始,打造你自己的街旁应用
——街旁Open API初级教程
这篇教程将手把手教你创建一个简单的街旁应用。
如果你还不清楚开放平台/OpenAPI/JSON/OAuth是什么,或是如何配置服务器(没关系,我在写街旁档案之前通通不会),请先阅读文末的附录:预备知识。
欢迎指出任何错误/问题。
1. 一个例子
以下通过一个简单的例子,让你对街旁OpenAPI有一个直观的认识。(我就是这么走过来的呀(感叹状))
以locations/show这个API为例。这个API的作用是获取地点信息,如地主,惊喜,经纬度等等。
在浏览器地址栏中输入以下地址:
http://api.jiepang.com/v1/locations/show?guid=909E9F8AC5F24E5D&source=100000
其中,http://api.jiepang.com/v1/locations/show为API地址;参数guid为街旁地点id,值为909E9F8AC5F24E5D,是园咖啡在街旁的地点ID;参数source为街旁应用的App ID。
便会得到街旁服务器返回的一串JSON数据,像这个样子:
{
"tel": "010-62558788",
"checkin_num": 104,
"guid":"909E9F8AC5F24E5D",
"mayor": {
"nick":"SottiX",
"avatar_thumb":"http://img.jiepang.com/avatar/08/263566308_thumb.jpg",
"avatar_small":"http://img.jiepang.com/avatar/08/263566308_small.jpg",
"id": 263566308,
"avatar":"http://img.jiepang.com/avatar/08/263566308.jpg"
},
"addr": "海淀区西苑草场5号畅春园食街A10号(近北京大学西门)",
"name": "园·咖啡",
……………………
}
以上JSON数据表示了园咖啡的地点数据,如电话是010-62558788,地主是我(哇咔咔),地址在畅春园食街A10等等。
在你的应用中,调用API的过程十分类似,只是需要用某种服务器端/客户端脚本调用而已。
2. Here we go
2.1 创建应用