OPhone Web API简介

OPhone Web API 目前被分为Auth，Location，Profile，Contact，Search，Messaging，SMS，RSS，Camera，Gallery，Setting 11大类。


1. Auth：主要提供第三方应用程序做认证的接口

2. Location：提供给第三方应用获取Ophone location信息的接口

3. Profile：提供给第三方应用获取Ophone 用户基本信息的接口

4. Contact：提供给第三方应用获取Ophone用户Contact操作相关的接口。如获取Contact信息，添加Contact信息，删除Contact信息。

5. Search：提供给第三方应用搜索Ophone 信息的接口，该接口提供对contact，message,call 等信息的搜索。

6. Messaging：提供给第三方应用向Ophone发送即时信息的接口。该信息有别与Ophone的短消息。

7. SMS：提供给第三方应用调用Ophone message接口向其它Phone 发送短消息的能力

8. RSS：提供给第三方应用获取Ophone 共享信息的接口，Ophone 用户可以将手机的图片，个人基本信息（年龄，学校，工作单位 等），个人当前位置等信息share 给用户。

9. Camera：提供给第三方应用调用Ophone camera接口拍照的能力，该接口需要Ophone用户的交互，当Ophone 允许拍照时，照片会实时传回给第三方应用程序。

10. Gallery：提供给第三方应用访问Ophone 图片的能力。

11. Setting：提供给第三方应用获取Ophone API权限设置，重置Ophone API的能力

OPhone Web API 安全控制


用户最关心的问题应该是用户信息安全了。为保证OPhone用户的信息安全，OPhone Web API做了严格的权限控制设计，我们对访问者采用了当前广为应用的Oauth认证。同时OPhone Owner可以为每一个API设定访问权限。该权限分为guest，friend，private三种，用户可以自行设定，guest权限的API表示任何用户都可以获取该API提供的信息，friend权限API表示只有获取相应授权的用户才能获取该API提供的信息，private权限的API表示只有OPhone Owner才能获取该API提供的信息。

如何使用 OPhone Web API


首先，开发者必须到OPhone Web API指定的网址注册一个开发账号，并为他的应用程序申请一个API key ，Secret key。因为第三方应用程序能够访问到的OPhone 必须是注册到相应服务器上的OPhone。所以如果OPhone Owner 希望通过第三方应用程序访问到自己的OPhone，就必须将OPhone 注册到该服务器上。


OPhone Web API 会给第三方开发者提供一个Client SDK，使开发者很方便的可以调用OPhone Web API接口。


下面我将以调用Location接口为例，讲解具体使用Client SDK 调用OPhone API的方法。

1.访问者要访问某个OPhone前必须获得该OPhone的Access token,Secret token。Access token,Secret token是Oauth中提到的一个重要概念，具体可参考资料：http://oauth.net/core/1.0

Access token 方法可调用如下方法获取：

[code="java"]# String apiKey = fa48c46b203cdd1101203ce264110006;

# String secret = 311838e72aa520af53580a5c6d65c56f;

#

# PhoneapiforWeb web = new PhoneapiforWeb(request,response,apiKey,secret);

# String callback = "";

# try {

# web.toAuth("http://apps.facebook.com/omssample/mwsapp.do?method=binding");

# } catch (IOException e1) {

# //IOException progress

# } catch (OAuthException e1) {

# //OauthException progress

# } catch (URISyntaxException e1) {

# //URISyntaxException progress

# }

# PhoneapiService service = web.getService();

# String accesstoken = service.accessor.accessToken

# String tokensecret = service.accessor.tokenSecret;

# String phoneid = (String)service.accessor.getProperty("user"); [/code]

web.toAuth( String callbackurl)方法会检测当前用户有没有获取accesstoken，如果没有获取accesstoken, 页面会跳转到OPhone Web API得相应页面去登陆，从而产生accesstoken并通过callbackurl 回传给第三方应用程序。

2.应用程序获得accesstoken后便可以调用OPhone Web API 了。其调用过程如下：
1. PhoneapiService service = new PhoneapiService
2. (apiKey,secret,accesstoken ,tokensecret);
3. try {
4. service.getLocation("xml","");
5. } catch (Exception e) {
6. //error progress
7. }
8.
9. LocationResponse location = (LocationResponse)service.getResponsePOJO();
10. if (location != null&& !StringUtil.isEmpty(location.getLatitude())&& !StringUtil.isEmpty
11. (location.getLogitude())) {
12. String logitude = location.getLogitude();
13. String latitude = location.getLatitude();
14. }
获得logitude,latitude信息后，应用程序可以利用google map 的Web API展现OPhone owner的当前位置。