WebService

337平台提供的 web service 规格说明

公共参数

api支持jsonp协议的方法调用，以下为公共参数：

1.api_key 应用调用key用来识别调用者身份，请向相关人士索取

2.callback 如通过jsonp调用，必须通过此参数提供回调函数名 jsonp

3.format 可选json或xml格式，如不填写默认输出json格式

例如：

http://api.337.com/user/session?api_key=xlfc%40elex337_tw_1&callback=Elex337.ApiServer._callbacks.e121508720694aa

返回：

Elex337.ApiServer._callbacks.e121508720694aa({"status":-1})

在对返回内容说明时，此文档仅对“回调方法的参数”进行说明，即上例中的{"status":-1}

语言

某些api需要指定终端用户的语言（例如取游戏服列表功能）。语言参数可从以下表格内选取

语言	代号	语言	代号	语言	代号
繁体中文	tw	简体中文	cn	葡语	pt
德语	de	土耳其语	tr	英语	en
西班牙语	es	波兰语	pl	荷兰语	nl
阿拉伯	ar	泰语	th

在后续的api地址说明上，若地址中包含[lang]则表示需要提供语言参数 比如“取服列表”功能，面向繁体中文用户时，请请求http://www.337.com/tw/api/get_game_server

*如果不传递语言参数，则会由337服务器根据客户端信息判断用户语言。这将造成一定的性能损失与延迟。

1.登陆

URL: http://api.337.com/user/login

参数

参数	说明
password	密码
username	账号

例： http://api.337.com/user/login?callback=Elex337.ApiServer._callbacks.e1b8225b3e1c336&lang=tw&password=udontwannaknow&username=baoyu430

返回服数组：

参数	说明
uid	平台uid
identify_id	平台的identify_id
username	用户名
nickname	昵称
gender	性别
birthday	生日
avatar	头像
level	用户等级
language	使用者语言
loginkey	loginkey
session_key	session_key

2.登出

URL: http://api.337.com/user/logout

参数 无

例： http://api.337.com/user/logout

3.注册

URL: http://api.337.com/user/register

参数

参数	说明
password	密码
username	账号
email	邮件

返回服数组：

参数	说明
uid	平台uid
identify_id	平台的identify_id
username	用户名
nickname	昵称
gender	性别
birthday	生日
avatar	头像
level	用户等级
language	使用者语言
loginkey	loginkey
session_key	session_key

4.取服列表

URL： http://www.337.com/[lang]/api/get_game_server

参数

参数	说明
gKey	所查询游戏的gKey

例： http://www.337.com/tw/api/get_game_server?api_key=xlfc%40elex337_tw_1&gKey=xlfc%40elex337_tw_1

返回服数组：

参数	说明
key	服id
version	服版本号
lang	服的发布语言
sns_type	发布平台类型
weight	权重
title	服名称
status	服状态
url	服链接

5.取游戏新闻&攻略

URL: http://www.337.com/[lang]/api/get_site_news

参数

参数	说明
gKey	所查询游戏的gKey
type	1表示新闻；4表示攻略，默认为1
max	最多返回条数，默认为5

例： http://www.337.com/tw/api/get_site_news?api_key=xlfc%40elex337_tw_1&gKey=xlfc%40elex337_tw_1&type=1

返回服数组：

参数	说明
did	文章id
link	文章链接
time	文档创建时间
title	文章标题

6.取玩家的游戏历史

URL: http://www.337.com/[lang]/api/get_user_game_server

参数

参数	说明
gKey	所查询游戏的gKey
gameuid	gameuid

例： http://tw.337.com/api/get_user_game_server?gameuid=elex337_23577489&gKey=ddt@elex337_pt_1

返回服数组：

参数	说明
server_name	服名称
last_play_time	上一次游戏时间
server_id	服id
url	游戏地址

7.取论坛帖子

URL: http://www.337.com/[lang]/api/get_forum_threads

参数

参数	说明
type	类型[new|digest|stick|hot]
gKey	游戏gKey
fields	字段(可不填)
page	分页(可不填)
items	分页时每页最多显示(可不填)

例： http://tw.337.com/api/get_forum_threads?fields=author,lastpost&gKey=farm@facebook_tw&type=new

返回服数组：

参数	说明
fid	fid
tid	tid
subject	标题
url	链接地址