常见问题

Q:开发者如何获得App key?

A: API接口仅限商务合作使用,申请商务合作请联系api@dianping.con。

 

Q:App key是否有有效期?

A:App key一旦生成即刻生效,如果开发者在90天内没有任何调用,大众点评有权回收开发者的App key。

 

Q:开发者如果怀疑自己的App key和app secret泄露了,应该怎么办?

A:开发者应该立即登录开发者平台网站的应用管理台,重置app secret,之后改用新的app secret生成请求签名,此时再使用以前的app secret生成的签名将会失效,也将无法调用API。

 

Q:出现“Invalid sign. (sign签名参数值无效)”有哪些常见原因?

A:1、 App Key与App Secret不匹配

2、 SHA1方法有误,Java推荐使用common-codec 1.6版本

3、 生成sign签名时,中文的参数值没有先转换为UTF8编码

4、 对服务器发起HTTP Get请求时,所有请求参数必须先转为UTF8编码,否则会报错

 

Q:什么是测试数据?如何才能获取正式数据?

A:测试数据是大众点评开发者平台通过API提供给开发者在测试开发阶段时使用,商户类接口的部分信息字段独立于正式数据。企业或者个人在大众点评开发者平台注册成功后成为开发者,会自动获得测试数据权限,以供开发者测试开发时期使用。当开发者整合点评的API功能并完成测试开发后,就可以向大众点评开发者平台提交应用审核。如果审核通过,开发者将获得正式数据权限,即,API返回的数据自动切换为正式数据。

 

Q:为什么支持商户搜索的城市列表中没有我所在的城市?

A:目前开放的城市须满足在大众点评上的商户总数大于500,大众点评非常欢迎您添加身边的商户,帮助全球华人更好的了解您所在的城市,如果您希望批量添加,也可以发电子邮件至api@dianping.com 。

 

Q:为什么支持团购和优惠券搜索的城市列表中没有我所在的城市?

A:非常抱歉,大众点评尚未在您所在城市开通相关业务。您也可以订阅大众点评的团购邮件通知,大众点评会在开通相关服务的第一时间通知您!

 

Q:大众点评在对待个人开发者和公司开发者的申请上有什么区别吗?

A:没有明显区别,只是在开发者提交资料的时候,个人开发者须上传个人身份证扫描图片,公司开发者须上传公司营业执照扫描图片。

 

Q:开发者的API调用频次限制是多少?需要增加调用的频次上限,应该怎么办?

A:商户、点评类API的每日调用上限为10000次,其他API没有每日调用上限。开发者需要保证商户、点评类API访问都是来自用户的实时请求,如果每日10000次调用上限不能满足用户需求,可以将自己的应用信息(App key和应用名称)以及需要增加使用频次的理由发邮件至api@dianping.com,与大众点评商定新的标准。

 

Q:如果API调用失败,是否会计入当日调用总数?

A:需要依情况而定,如果开发者的API请求url中已经包含了请求签名(如何生成signature?),但是因为参数配置不当而造成调用失败,则会计入当日调用总数,如果因为未生成有效签名而调用失败,则不会被计数。

 

Q:大众点评会通过哪些信息审核开发者的应用?

A:首先,大众点评工作人员会审核开发者信息和应用信息是否正确填写,确认没有错填乱填,并根据开发者提供的应用信息初步判断是否符合《开发者协议》的要求;然后,工作人员会根据开发者提供的应用地址和截图详细查阅应用的内容,如果符合《开发者协议》和《审核规范》要求则通过审核,如果有任何问题,工作人员也可能通过开发者提供的电话或邮件联系本人,所以请开发者务必提交准确的应用地址、截图和联系方式。

 

Q:应用审核的时间需要多久?

A:大众点评工作人员会在三个工作日内回复开发者的审核申请,如果遇到问题,工作人员可能会通过开发者注册时预留的邮箱、电话等信息联系开发者。

 

Q:开发者应该如何申请使用非默认开通的高级接口?

A:按照平台规划,部分资源将以高级接口的形式开放给部分开发者,开发者可以将自己的应用信息(App key和应用名称)以及需要使用此类API的理由发邮件至api@dianping.com申请开通。

 

Q:开发者的应用审核为什么会被驳回?

A:开发者信息不准确、开发者名称与营业执照或身份证上不同、未提交应用截图、未按照要求设置大众点评logo或链接等都可能会导致应用审核被驳回,开发者可以在应用管理页面查看被驳回理由,提交审核前请务必对照《审核规范》检查自己的应用,以免审核被驳回,耽误进度。

 

Q:开发者应该用点评API做什么?

A:大众点评非常鼓励开发者使用点评API创造满足用户需求的产品,同时也会不断完善自身业务,给予开发者更多数据和服务上开放支持,所以我们希望开发者可以将创意和精力投入到与点评业务互补的产品形态中,而非简单复制点评的功能。

 

Q:注册成为开发者时,开发者收不到激活账号的验证邮箱邮件,导致无法注册?

A:请开发者尽可能用大众邮箱(qq.com、yahoo.cn、sina.com等)注册,如特殊原因必须使用公司邮箱注册,遇到上述情况,请邮件反馈至大众点评开放平台(api@dianping.com)。

 

Q:大众点评开放平台提供的团购API如何实现支付功能?

A:目前团购API通过跳转大众点评团购页面实现支付,所以开发者不需要考虑团购支付实现方法。如果开发者需要了解团购交易记录,可通过接入数据统计类API获取应用导入的团购交易的历史记录 stats/get_deal_transaction_history 获取交易信息。

 

Q:大众点评开放的数据是否可以用作数据分析以及科学研究?

A:目前大众点评开放平台API主要应用于面向最终用户的产品,暂时不支持数据分析类需求使用。

 

Q:在调用商户信息时,为什么APP返回的商户数量没有大众点评上的商户数量多?如何获取更多的商户信息?

A:目前大众点评开放平台允许开发者在一次请求中最多返回40条商户信息,未来我们将逐步开放商户数量上限。如果有必要更多的商户信息,应用可以采用跳转链接的方式跳转至大众点评相关网页。跳转链接可以在搜索商户API的结果字段business_url 中查找。

 

Q:如何获取大众点评开放平台API的SDK源代码?

A:您需要首先下载安装git,https://github.com/dianping/dianping-open-sdk ,使用git clone将文件下载到本地。您也可以是用Download ZIP功能将文件全部下载到本地,网址如下:https://codeload.github.com/dianping/dianping-open-sdk/zip/master