(以“=接入开发相关问题= ===网站认证及应用认证=== *1、网站认证申请要求是什么？ 网站官方微博认证要求网站有ICP备案号，微博...”为内容创建页面) |
|||
| （未显示4个用户的73个中间版本） | |||
| 第1行： | 第1行： | ||
| − | = | + | =常见问题= |
| − | = | + | <div class="wiki_txtJ"> |
| − | + | 收录了在接入微博开放平台过程中，最常遇到的问题和对应的解决方法。 | |
| − | + | </div> | |
| − | |||
| − | |||
| + | ==开发者注册及身份认证== | ||
| − | + | {{Qa|Q=开发者身份认证审核需要多久？ | |
| − | + | |A=1-3个工作日，如遇节假日顺延。 | |
| + | }} | ||
| − | + | {{Qa|Q=填写开发者信息时，“个人网站”怎么填？ | |
| − | + | |A=如果没有个人网站，可以填写本人微博个人主页地址，有个人网站的则如实填写即可。 | |
| + | }} | ||
| − | + | {{Qa|Q=注册开发者时选择开发者类型，其中“个人”类型开发者和“公司”类型开发者有什么区别？ | |
| − | + | |A=“个人”、“公司”类型的开发者，在注册认证流程上是一样的，只是在提交身份认证资质时有差别，“个人”类型的开发者只需要提交个人身份证的相关信息，“公司”类型的开发者则需要提交公司营业执照或组织机构代码证等信息，另外“公司”类型的开发者在申请开放平台能力权限和合作支持上有一定的优势。 | |
| + | }} | ||
| − | + | {{Qa|Q=在进行“公司”类型开发者身份认证时，税务登记证怎么上传？ | |
| − | + | |A=三证合一后，已经没有税务登记证了，身份认证时，税务登记证处重复上传一次公司营业执照或组织机构代码证即可。 | |
| + | }} | ||
| − | + | {{Qa|Q=开发者身份认证所提交的个人信息是否会得到保护？ | |
| − | + | |A=会的，微博开放平台会对开发者所提交的个人信息数据进行加密。 | |
| + | }} | ||
| − | |||
| − | |||
| + | ==应用创建及审核== | ||
| − | + | {{Qa|Q=应用提交审核后，审核需要多久？ | |
| − | + | |A=1-3个工作日，如遇节假日顺延。这里给出一些建议，应用在未提交审核前，处于开发中的状态，此时应用的APPKEY是可以用于调接口、集成SDK、嵌入组件的，除了有接口调用次数和授权人数的限制外，完全可以满足开发调试的需求，而且开发中的状态，修改应用信息都是即时生效的，反而是通过审核后再修改应用信息就需要额外的修改二次审核了，因此注册完应用后，不要急于提交审核，很多开发者还没有进行开发调试就急于提交审核，审核通过后才开始开发，结果开发过程中发现还需要反复修改应用的开发配置来进行调试，结果每次修改应用配置都需要等待修改二次审核通过后才能生效，反而耽误了开发进度。 | |
| + | }} | ||
| − | + | {{Qa|Q=应用修改后，修改二次审核需要多久？ | |
| − | + | |A=1-3个工作日，如遇节假日顺延。请参照上面一条中的建议，待开发调试大体完成后，再提交审核，可以减少因为修改应用信息，进而需要等待修改二次审核的情况。 | |
| − | + | }} | |
| − | + | {{Qa|Q=已通过审核的应用，修改了应用简介、授权回调地址、安全域名等应用信息后，新修改的配置不生效？ | |
| − | + | |A=已通过审核的应用，修改应用配置后，需要修改二次审核，当修改保存提交后，应用会进入二审待审状态，二次审核通过后，修改的应用配置信息才会生效，另外，应用数据有缓存，因此审核通过后，个别情况下会有几分钟的延迟才生效。因此，请结合上面两条中的建议，合理安排应用提交审核的时机，待开发调试大体完成后，再提交审核，减少因为修改应用配置，进而需要等待修改二次审核的情况。 | |
| + | }} | ||
| − | + | {{Qa|Q=我提交的应用审核被驳回了，收到了驳回理由，但还是不明白是什么意思该怎么处理？ | |
| − | + | |A=可以参见常见驳回理由说明。点击查看 [[常见驳回理由说明]] | |
| + | }} | ||
| − | + | {{Qa|Q=提交应用审核时，如何填写应用资料才能更有效的通过审核？ | |
| − | + | |A=应用信息填写完整，包括标准的应用图标和正确的应用描述、准确的开发者信息等，应用描述应与应用功能保持一致，应用名称应与应用或网站名称保持一致。举几个例子，某个开发者申请网页应用，其网站名叫“张三的个人博客”，而其提交的微博开放平台的应用名称却是“我的博客”，这种就会被驳回，如果提交时应用名称和网站一致，也是“张三的个人博客”，则就会通过审核。 | |
| + | }} | ||
| − | + | {{Qa|Q=应用通过审核后，还显示“申请上线”，却没有地方进行操作，该怎么处理？ | |
| − | + | |A=由于微博开放平台的应用中心进行了改版，目前暂时没有上架到应用中心的功能，因此应用审核通过就是最终状态，不影响应用APPKEY的使用，无需再进行“申请上线”。 | |
| + | }} | ||
| − | + | {{Qa|Q=注册应用时，我想使用的应用名称提示已经存在、无法注册，该怎么办？ | |
| + | |A=遇到这种情况，一般有如下几种原因：1、应用名称包含“微博”、“新浪”字样，该类名称仅微博官方产品可以使用；2、应用名称中包含一些品牌保护词，比如包含某知名品牌的名字，如果开发者所在的机构确实是品牌拥有者，请与微博开放平台官方微博账号联系，这边会帮助品牌方完成注册；3、应用名称已被其他开发者注册，此时开发者只能换一个名字了，而如果这个名字是开发者注册有效的商标，请与微博开放平台官方微博账号联系，这边会帮助商标所有方完成注册；4、包含“企业”、”政府”、“媒体”、“蓝V”等字样的名称，只有微博官方产品、或者开放平台认证的合作机构可以使用。 | ||
| + | }} | ||
| − | == | + | {{Qa|Q=我想修改应用的类型，比如从“网页应用”改为“移动应用”，可以吗？ |
| − | + | |A=目前应用类型无法变更，请开发者根据自己的需要，准确选择应用类型，如果有需要，可以新注册自己需要的另外一种应用类型。 | |
| − | + | }} | |
| − | + | {{Qa|Q=我开发的是 iOS 应用，苹果 app store 上架前也要审核，怎么处理和微博开放平台审核之间的顺序问题？ | |
| − | + | |A=请先如实填写应用信息，应用名称、应用描述都尽量与实际相符，应用地址也先填写 app store 上对应的地址，尽管该地址可能因为苹果还没有审核上架，暂时无法打开，我们依旧会对此移动应用先通过审核，以免应用在 app store 方面审核上架时遇到问题，在 app store 通过审核后，如果有需要请及时修改微博开放平台上应用的相关信息，比如客户端下载页面地址更换为正式的 app store 应用地址，我们将在移动应用通过审核后十个工作日进行复查，复查时如应用地址无对应客户端可下载，将进行审核驳回操作。 | |
| + | }} | ||
| − | |||
| − | |||
| + | ==媒体平台接入== | ||
| − | + | {{Qa|Q=为什么我的应用，通过调用接口发出来的微博，显示“来自未审核应用”？ | |
| − | + | |A=应用只有通过审核之后，才会显示应用名称为微博的来源。 | |
| + | }} | ||
| − | + | {{Qa|Q=如何通过微博ID拼接得到单条微博正文页地址？ | |
| − | + | |A=单条微博正文页地址规则：<nowiki>https://weibo.com/detail/微博ID</nowiki> | |
| + | }} | ||
| − | |||
| − | |||
| + | ==网页应用接入== | ||
| − | + | {{Qa|Q=网页嵌入了微博分享按钮，但是分享后微博显示的来源不是我的网页应用名称，而是“分享按钮”？ | |
| − | + | |A=分享按钮组件，显示分享来源为第三方网页应用名称，需满足如下条件：网页应用已经通过审核，同时绑定了安全域名，且分享的链接必须在绑定的安全域名下，需要注意的是，分享的链接需要放在url参数里，而不是放在title参数里。 | |
| + | }} | ||
| − | |||
| − | |||
| + | ==开放接口问题== | ||
| − | + | {{Qa|Q=微博开放接口都有哪些？ | |
| − | + | |A=请参阅微博开放接口文档：[[微博API]] 。 | |
| + | }} | ||
| − | + | {{Qa|Q=遇到 error : applications over the unaudited use restrictions 错误怎么解决？ | |
| − | + | |A=未通过审核的应用只有应用创建者和开发测试用户能完成应用授权并调用接口，开发测试用户设置方法，在 “我的应用>应用信息>测试信息>测试账号” 处添加，每个未通过审核的应用，最多只能添加15个微博账号作为开发测试人员，注意：添加后约半小时左右生效，同时，开发测试人员目前暂不支持修改更换，请您谨慎添加，此外，当应用通过审核后，该限制就自动消失了，所有微博用户都对应用进行授权并调用接口。 | |
| + | }} | ||
| − | + | {{Qa|Q=如何获取当前用户及应用的API访问频率限制情况？ | |
| − | + | |A=可以通过调用 [[2/account/rate_limit_status|account/rate_limit_status]] 接口获取。 | |
| + | }} | ||
| − | + | {{Qa|Q=接口返回 The server returned an invalid or incomplete response. please try again later. | |
| − | + | |A=这个错误是国内网络跟国外网络交互时有非法内容的提示，请检查是否使用了国外服务器代理。 | |
| + | }} | ||
| − | + | {{Qa|Q=我某个应用的 app secret 疑似泄露了，该怎么办？ | |
| − | + | |A=应用的 app secret 是非常重要的，因此应当确保其安全性，如果您发现其疑似泄露，需要及时重置 app secret ，可以在“我的应用>应用信息>高级信息”下，选择“重置 app secret”，注意，重置后，原 app secret 将作废，请及时在自己的代码里更换重置后的新的 app secret 。 | |
| + | }} | ||
| − | |||
| − | |||
| + | ==应用授权问题== | ||
| − | + | {{Qa|Q=遇到 error : redirect_uri_mismatch 怎么解决？ | |
| − | + | |A=报错原因是因为授权回调地址（redirect_uri 参数）不匹配引起的，对应错误码 21322，授权接口中的 redirect_uri 参数，即授权回调地址，传的值需与在开放平台网站填写的授权回调地址完全一致，设置填写位置：“我的应用>应用信息>高级信息” ，另外请注意，回调地址多为一个URL格式的参数，作为GET参数传递时，需要进行URLencode。 | |
| + | }} | ||
| − | + | {{Qa|Q=授权 access_token 的有效期是多久？ | |
| − | + | |A=微博开放平台授权服务采用 OAuth2.0 协议，对于未审核应用授权有效期为24小时，对于已通过审核的网页应用和移动应用来说，授权有效期最低为30天，其他不同的应用类型有不同的授权策略，可以详见：[[授权机制]] 。 | |
| + | }} | ||
| − | + | {{Qa|Q=用户的授权 access_token 过期后，我们应该如何维护这个用户的授权 access_token？ | |
| − | + | |A=可以通过授权接口给您返回的过期时间进行计算，如果用户授权已经过期，就需要重新引导用户进行再次授权，获得新的授权 access_token 后，替换已经过期的 access_token ，维护好这个用户在自己产品内的授权生命周期。 | |
| − | + | }} | |
| − | + | ||
| − | + | ||
| − | + | {{Qa|Q=授权回调地址在那里设置？ | |
| − | + | |A=在 “我的应用>应用信息>高级信息>授权设置” 里设置。 | |
| + | }} | ||
| + | |||
| + | |||
| + | {{Qa|Q=怎么能获取到 refresh token？ | ||
| + | |A=移动应用在嵌入微博SDK后，通过SDK授权，在返回 access_token 的同时，还会返回一个 refresh token，除此之外，暂时不开放获取 refresh token 的能力申请。 | ||
| + | }} | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | {{#a:nobtns|noheading}} | ||
| + | __NOTOC__ | ||
2022年12月21日 (三) 11:31的最后版本
常见问题
收录了在接入微博开放平台过程中，最常遇到的问题和对应的解决方法。
开发者注册及身份认证
开发者身份认证审核需要多久？
1-3个工作日，如遇节假日顺延。
填写开发者信息时，“个人网站”怎么填？
如果没有个人网站，可以填写本人微博个人主页地址，有个人网站的则如实填写即可。
注册开发者时选择开发者类型，其中“个人”类型开发者和“公司”类型开发者有什么区别？
“个人”、“公司”类型的开发者，在注册认证流程上是一样的，只是在提交身份认证资质时有差别，“个人”类型的开发者只需要提交个人身份证的相关信息，“公司”类型的开发者则需要提交公司营业执照或组织机构代码证等信息，另外“公司”类型的开发者在申请开放平台能力权限和合作支持上有一定的优势。
在进行“公司”类型开发者身份认证时，税务登记证怎么上传？
三证合一后，已经没有税务登记证了，身份认证时，税务登记证处重复上传一次公司营业执照或组织机构代码证即可。
开发者身份认证所提交的个人信息是否会得到保护？
会的，微博开放平台会对开发者所提交的个人信息数据进行加密。
应用创建及审核
应用提交审核后，审核需要多久？
1-3个工作日，如遇节假日顺延。这里给出一些建议，应用在未提交审核前，处于开发中的状态，此时应用的APPKEY是可以用于调接口、集成SDK、嵌入组件的，除了有接口调用次数和授权人数的限制外，完全可以满足开发调试的需求，而且开发中的状态，修改应用信息都是即时生效的，反而是通过审核后再修改应用信息就需要额外的修改二次审核了，因此注册完应用后，不要急于提交审核，很多开发者还没有进行开发调试就急于提交审核，审核通过后才开始开发，结果开发过程中发现还需要反复修改应用的开发配置来进行调试，结果每次修改应用配置都需要等待修改二次审核通过后才能生效，反而耽误了开发进度。
应用修改后，修改二次审核需要多久？
1-3个工作日，如遇节假日顺延。请参照上面一条中的建议，待开发调试大体完成后，再提交审核，可以减少因为修改应用信息，进而需要等待修改二次审核的情况。
已通过审核的应用，修改了应用简介、授权回调地址、安全域名等应用信息后，新修改的配置不生效？
已通过审核的应用，修改应用配置后，需要修改二次审核，当修改保存提交后，应用会进入二审待审状态，二次审核通过后，修改的应用配置信息才会生效，另外，应用数据有缓存，因此审核通过后，个别情况下会有几分钟的延迟才生效。因此，请结合上面两条中的建议，合理安排应用提交审核的时机，待开发调试大体完成后，再提交审核，减少因为修改应用配置，进而需要等待修改二次审核的情况。
我提交的应用审核被驳回了，收到了驳回理由，但还是不明白是什么意思该怎么处理？
可以参见常见驳回理由说明。点击查看 常见驳回理由说明
提交应用审核时，如何填写应用资料才能更有效的通过审核？
应用信息填写完整，包括标准的应用图标和正确的应用描述、准确的开发者信息等，应用描述应与应用功能保持一致，应用名称应与应用或网站名称保持一致。举几个例子，某个开发者申请网页应用，其网站名叫“张三的个人博客”，而其提交的微博开放平台的应用名称却是“我的博客”，这种就会被驳回，如果提交时应用名称和网站一致，也是“张三的个人博客”，则就会通过审核。
应用通过审核后，还显示“申请上线”，却没有地方进行操作，该怎么处理？
由于微博开放平台的应用中心进行了改版，目前暂时没有上架到应用中心的功能，因此应用审核通过就是最终状态，不影响应用APPKEY的使用，无需再进行“申请上线”。
注册应用时，我想使用的应用名称提示已经存在、无法注册，该怎么办？
遇到这种情况，一般有如下几种原因：1、应用名称包含“微博”、“新浪”字样，该类名称仅微博官方产品可以使用；2、应用名称中包含一些品牌保护词，比如包含某知名品牌的名字，如果开发者所在的机构确实是品牌拥有者，请与微博开放平台官方微博账号联系，这边会帮助品牌方完成注册；3、应用名称已被其他开发者注册，此时开发者只能换一个名字了，而如果这个名字是开发者注册有效的商标，请与微博开放平台官方微博账号联系，这边会帮助商标所有方完成注册；4、包含“企业”、”政府”、“媒体”、“蓝V”等字样的名称，只有微博官方产品、或者开放平台认证的合作机构可以使用。
我想修改应用的类型，比如从“网页应用”改为“移动应用”，可以吗？
目前应用类型无法变更，请开发者根据自己的需要，准确选择应用类型，如果有需要，可以新注册自己需要的另外一种应用类型。
我开发的是 iOS 应用，苹果 app store 上架前也要审核，怎么处理和微博开放平台审核之间的顺序问题？
请先如实填写应用信息，应用名称、应用描述都尽量与实际相符，应用地址也先填写 app store 上对应的地址，尽管该地址可能因为苹果还没有审核上架，暂时无法打开，我们依旧会对此移动应用先通过审核，以免应用在 app store 方面审核上架时遇到问题，在 app store 通过审核后，如果有需要请及时修改微博开放平台上应用的相关信息，比如客户端下载页面地址更换为正式的 app store 应用地址，我们将在移动应用通过审核后十个工作日进行复查，复查时如应用地址无对应客户端可下载，将进行审核驳回操作。
媒体平台接入
为什么我的应用，通过调用接口发出来的微博，显示“来自未审核应用”？
应用只有通过审核之后，才会显示应用名称为微博的来源。
如何通过微博ID拼接得到单条微博正文页地址？
单条微博正文页地址规则：https://weibo.com/detail/微博ID
网页应用接入
网页嵌入了微博分享按钮，但是分享后微博显示的来源不是我的网页应用名称，而是“分享按钮”？
分享按钮组件，显示分享来源为第三方网页应用名称，需满足如下条件：网页应用已经通过审核，同时绑定了安全域名，且分享的链接必须在绑定的安全域名下，需要注意的是，分享的链接需要放在url参数里，而不是放在title参数里。
开放接口问题
微博开放接口都有哪些？
请参阅微博开放接口文档：微博API 。
遇到 error : applications over the unaudited use restrictions 错误怎么解决？
未通过审核的应用只有应用创建者和开发测试用户能完成应用授权并调用接口，开发测试用户设置方法，在 “我的应用>应用信息>测试信息>测试账号” 处添加，每个未通过审核的应用，最多只能添加15个微博账号作为开发测试人员，注意：添加后约半小时左右生效，同时，开发测试人员目前暂不支持修改更换，请您谨慎添加，此外，当应用通过审核后，该限制就自动消失了，所有微博用户都对应用进行授权并调用接口。
如何获取当前用户及应用的API访问频率限制情况？
可以通过调用 account/rate_limit_status 接口获取。
接口返回 The server returned an invalid or incomplete response. please try again later.
这个错误是国内网络跟国外网络交互时有非法内容的提示，请检查是否使用了国外服务器代理。
我某个应用的 app secret 疑似泄露了，该怎么办？
应用的 app secret 是非常重要的，因此应当确保其安全性，如果您发现其疑似泄露，需要及时重置 app secret ，可以在“我的应用>应用信息>高级信息”下，选择“重置 app secret”，注意，重置后，原 app secret 将作废，请及时在自己的代码里更换重置后的新的 app secret 。
应用授权问题
遇到 error : redirect_uri_mismatch 怎么解决？
报错原因是因为授权回调地址（redirect_uri 参数）不匹配引起的，对应错误码 21322，授权接口中的 redirect_uri 参数，即授权回调地址，传的值需与在开放平台网站填写的授权回调地址完全一致，设置填写位置：“我的应用>应用信息>高级信息” ，另外请注意，回调地址多为一个URL格式的参数，作为GET参数传递时，需要进行URLencode。
授权 access_token 的有效期是多久？
微博开放平台授权服务采用 OAuth2.0 协议，对于未审核应用授权有效期为24小时，对于已通过审核的网页应用和移动应用来说，授权有效期最低为30天，其他不同的应用类型有不同的授权策略，可以详见：授权机制 。
用户的授权 access_token 过期后，我们应该如何维护这个用户的授权 access_token？
可以通过授权接口给您返回的过期时间进行计算，如果用户授权已经过期，就需要重新引导用户进行再次授权，获得新的授权 access_token 后，替换已经过期的 access_token ，维护好这个用户在自己产品内的授权生命周期。
授权回调地址在那里设置？
在 “我的应用>应用信息>高级信息>授权设置” 里设置。
怎么能获取到 refresh token？
移动应用在嵌入微博SDK后，通过SDK授权，在返回 access_token 的同时，还会返回一个 refresh token，除此之外，暂时不开放获取 refresh token 的能力申请。
