常见问题帮助

1、注册登录问题

在使用天聚数行接口前,请先点击右上角注册账号,注册成功即为普通会员用户。

成功注册后,您的昵称/邮箱地址即为平台的有效账号,可用于下次登录等。如绑定了安全手机,同样可作为账号使用。

建议您在注册完成后,通过控制台 - 我的账号 - 第三方账号,绑定常用的第三方账号,以方便下次一键登录。

绑定微信服务号可用于PC端、小程序端快捷登录,同时可以更方便及时的接收系统提醒和安全告警消息和查询账号状态。

2、实名认证问题

依据《中华人民共和国网络安全法》等相关法律法规要求,必须完成真实身份信息认证后,才可使用相关接口服务。

新注册用户请在7个工作日内完成身份实名认证,逾期未认证将会影响接口正常服务。感谢配合和理解!

认证方式,登录控制台 - 账号管理 - 实名认证,根据页面提示填写相关信息,一键自助认证。

请根据账号或项目实际归属方,选择合适的认证身份,避免产生交接问题。此外,部分接口可能只有对应身份才可使用。

工作日内,身份实名认证审核时间一般为10-60分钟内,非工作日期间,不定时审核。通过与否可留意系统消息通知。

3、接口申请和费用问题

登录天聚数行后,可通过首页或搜索框检索需要使用的接口,点击进入接口文档页面申请接口即可。

本平台接口类型分为两种,按次计费接口(以下称计次接口)和会员免费接口(以下称免费接口)。

计次接口,和用户会员等级无关任何用户不限申请数量。计次接口请求量不支持包年包月,每次调用独立计费。

免费接口,普通会员最多可申请10个,高级会员及黄金会员不限个数。免费类接口请求量支持包年包月。

你可以在控制台 - 数据管理中查看每个接口的详细信息,包含赠送次数,可用余量和调用频率等。

每次调用接口消耗的天豆可在控制台 - 接口管理 - 额度扣减明细中查看,支持最近的3000条记录。

天豆是平台的计费道具,1万颗天豆等于1块钱,不同接口所消耗的天豆不同,具体请参考接口文档。

4、会员等级问题

会员等级分为三种,注册即为普通会员。可付费升级为高级会员或黄金会员,支持按年或按月。

普通会员,可申请10个免费接口,每个免费接口每天可用100次请求量,每秒最高可请求10次。

高级会员,可申请所有免费接口,每个免费接口每天可用10000次请求量,每秒最高可请求20次。

黄金会员,可申请所有免费接口,每个免费接口每天可用500000次请求量,每秒最高可请求30次。

会员到期后,不影响已有接口使用,且当天可以继续使用可用余量,第二天起恢复到普通会员权益。

只有了标明了会员免费的接口,才可以使用以上会员权益。计次类接口不支持会员,只能按次计费。

5、接口调用问题

这里以微信精选接口为例,点击链接进入接口文档页后,你可以看到接入信息和请求参数:

接口文档

如上图接口信息,写明了接口地址和支持请求方式,get方式可以直接在接口地址后面拼接参数,post方式参数需在消息体body中发送。

如:http://apis.tianapi.com/wxnew/index?key=你自己的apikey&num=10&page=1

其中key参数值,可在控制台-数据管理-我的密钥KEY中查看。

num参数后面的10表示需要返回10条信息,page后面的1表示第1页。具体支持的范围请查看请求参数表中的备注一栏。

调用参数

上图中列举了微信精选这个接口,所有支持的请求参数。必填参数是缺一不可的,非必填参数可按需使用。

接口返回240错误提示缺少key参数,请检查是否传递了key参数或者编码格式是否符合要求。

接口返回250错误提示返回数据为空,请检查输入值是否符合要求或注意中文编码问题。

天聚数行接口默认返回的数据格式为json,字符编码为utf-8,请求参数的编码类型content-type为application/x-www-form-urlencoded

在每个接口文档底部,有常见编程语言的代码可以参考。如果你无法理解,建议通过网络学习后再使用,关键词如”php json“,”java json“等。

遇到问题可通过在线测试检查,接口不会区别调用环境,在线测试也是正常的调用流程。由于生产环境复杂多样,请自行排查可能存在的问题。

建议使用https协议请求接口,更加稳定和安全,避免存在网络劫持等情况,特别是IOS端或者各平台的小程序在调用接口时必须使用https协议。

成功发起调用后,可在控制台 - 接口管理 - 接口请求日志/接口调用记录查看相关请求信息。参考文章:善用接口管理功能排查接口问题

请保管好你的接口密钥key,如泄露可在控制台 - 我的密钥中重置。或者设置白名单拦截第三方恶意调用天聚数行接口防盗刷设置

我们强烈建议您应该从后端服务器中发起对我们的API请求,这样的架构较为安全灵活且易维护。

6、充值和发票问题

免费接口可以通过升级会员获得更高每日请求量,计次接口可以充值天豆来增加调用次数。

充值完成后可在控制台 - 财务管理 - 充值流水记录中查看本次充值的相关信息,如未到账请及时联系客服处理。

发票内容统一为:*信息技术服务*技术服务费,不能开具其他的抬头。

订单累计金额50元以上可开具发票,少于50元时可累积到下次一起申请。

增值税普通发票仅需填写企业抬头和纳税人识别号,增值税专用发票需要补充公司地址、开户行对公账号等全部完整信息。

平台支持开具增值税电子普通发票,如您为一般纳税人且需要增值税专用发票(只能开具纸质版),请补充快递收件信息。

发票问题请点击控制台 - 财务管理 - 发票管理填写发票信息,具体要求可在填写完毕后联系客服。

7、退款规则问题

如因天聚数行平台原因接口不可用,平台将根据充值时的折扣比例综合计算后的余款全额退给用户。

举例:用户100元充值了110W天豆,余量有80W天豆,平台原因不可用,退款为100/110*80=72.73元。

如因用户自身原因不再使用了发起退款,平台需收取20%冲抵财务成本,余下部分原路退给用户。

举例:同样条件下,由于用户自身原因退款,冲抵成本72.73*20%=14.54元,72.73-14.54=实际退款58.19元。

注意:超过一年的充值订单无论哪方原因均不支持退款。已开具发票的,需要联系客服退还同等金额的发票。

会员退款规则,会员开通三天内且免费接口用量低于100次/天,可申请全额退款。超过三天或超过100次,不支持退款。

8、其他注意事项

使用本站任何服务或接口,请遵守有关法律法规,不得用于任何非法目的。否则将封禁接口权限或账号,必要时将向安全机关举报处理。

采集抓取类接口,如获取网页图像、网页转API等接口,不得采集或抓取含有他人著作权的内容,建议您注明内容来源并得到对方授权。

工单 客服