帖子

【经验分享】WebAPI的使用和IP白名单问题汇总(10105、40202)

[复制链接]
  • TA的每日心情

    昨天 09:19
  • 签到天数: 176 天

    [LV.7]常住居民III

    15240  楼主| 小七 发表于 2019-12-12 11:23:41 1#
    很多刚接触讯飞开放平台的小伙伴们可能对WebAPI的使用存在一定的疑惑,在这里我介绍下服务的使用方法。
    首先需要点击控制台创建应用 - 然后点击应用选择要使用的服务(必须确认该appid下的该服务有服务量才可以使用) - 下载demo – 设置appid、key和IP白名单(部分服务有secret)即可运行demo调用该服务。

    若果出现类似如下报错,则说明是IP白名单的问题
    示例:{"code":"10105","data":"","desc":"illegal access|illegal client_ip: XX.XX.XX.XX","sid":"hts……77400"}
    illegal client_ip解决办法
           打开 控制台-选择使用的应用-所使用的服务-IP白名单,将报错信息中的XX.XX.XX.XX 设置进去,5分钟左右即可生效后或者关闭IP白名单不限制IP使用

    IP白名单部分服务会默认开启,部分服务会默认关闭。具体策略如下:
             默认关闭的服务:听写、合成、性别年龄识别、拍照速算、机器翻译、机器翻译(niutrans)。 其余WebAPI服务均默认开启IP白名单,需要设置外网IP或者关闭IP白名单才可使用服务。
             若打开IP白名单,接口认为IP不限,不会校验IP。
             若关闭IP白名单,则服务端会检查调用方IP是否在讯飞开放平台配置的IP白名单中,对于没有配置到白名单中的IP发来的请求,服务端会拒绝服务。
    IP白名单注意事项
            1. IP白名单中的应是外网IP,若设置的是内网IP(局域网IP),比如192.168开头的,或127.开头的,是没有意义的。
            2. 外网IP可打开百度,输入“IP”点击搜索确认。设置后5分钟左右才会生效。
            3. IP白名单功能开关关闭时为不限制IP;开启时需要设置IP才可访问。
            4. 请仔细检查 IP白名单中的IP 和报错信息中的IP是否一致,有多位用户仅是数字错误导致接口报错。
            4. 请仔细检查 设置了IP白名单的服务,与 实际调用的接口URL,是否匹配(可查看开发文档)。
            5. 外网IP可能会发生变化,请将所有可能的IP都设置进去。
            6. 控制台最多可设置5个IP,建议在固定IP的服务器端使用,多个IP用换行隔开。
            6. 设置的是国外的IP,不排除接口不支持的可能。

    写在最后:
    讯飞开放平台提供的WebAPI接口,在调用时,授权认证通过后,服务端会检查调用方IP是否开启IP白名单,IP白名单开启的话需请求IP在讯飞开放平台配置的IP白名单中,对于没有配置到白名单中的IP发来的请求,服务端会拒绝服务,这是一项安全措施。为确保安全性,我们强烈建议在固定IP的服务器端使用。
    其他的10105信息,比如illegal X-CheckSum,no appid info,一般是授权信息填写错误或者并未点击控制台的该服务。请确认授权信息填写是否正确,该appid下的该服务是否有服务量。如有疑问可提交工单咨询。


    WebAPI服务.png