知识库文章

Bing Webmaster SOAP/POX 接口退役:旧脚本怎样迁到 JSON API?

文章摘要
以完整GET请求、JSON响应和Python解析演示Bing统计迁移,另对照SubmitUrl的POST与d:null,再切换原任务入口。

本页阅读目录

盘点旧SOAP与POX任务后映射到Bing Webmaster JSON接口,并分别验收报表与URL提交

自动提交网址或读取Bing报告的脚本若仍使用SOAP、POX,需要迁移。Bing Webmaster已在2026年8月31日停用这两种方式;改成REST/JSON时,请求、返回数据的解析和定时任务入口要一起改。

对运营来说,常见现象是自动提交失败,或报表突然空白。对开发来说,不能只替换一个网址:旧脚本读XML,新接口回JSON,即使请求成功,旧解析程序也可能取不到数字。 接口恢复后仍要确认网址实际经历了什么;可参考发现、抓取与索引的排查顺序组织记录,其中Google和Bing的数据入口须分别使用。

先改一项只读统计:请求与返回结构一起迁

以GetRankAndTrafficStats为例。下面的域名和API Key都是占位,展示同一统计任务的请求迁移;没有访问真实账户。旧POX调用路径形如:

GET https://ssl.bing.com/webmaster/api.svc/pox/GetRankAndTrafficStats?siteUrl=https%3A%2F%2Fexample.com%2F&apikey=YOUR_API_KEY

迁到官方JSON入口时,同一只读方法使用GET,站点参数仍做URL编码:

GET https://ssl.bing.com/webmaster/api.svc/json/GetRankAndTrafficStats?siteUrl=https%3A%2F%2Fexample.com%2F&apikey=YOUR_API_KEY

逐项核对方法、HTTP动作与参数,不能把所有旧SOAP操作都当成GET。旧SOAP调用可能使用XML信封(Envelope)与代理对象;迁移时按对应JSON方法重新构造,不只是全局替换字符串。微软统计方法文档

旧XML节点怎样变成JSON记录

例如旧解析器在XML里找Clicks节点,新结果的精简教学形式是:

{"d":[{"Clicks":15,"Impressions":100,"Date":"/Date(1316156400000-0700)/"}]}

实际记录在d数组中。Clicks和Impressions是计数,Date是微软日期表示;开头数字是Unix毫秒,后面的偏移不是应再加减一次的毫秒。下面把日期转成明确UTC,再交给报表做目标时区显示:

import re from datetime import datetime, timezone def traffic_rows(payload): rows = payload.get("d") if not isinstance(rows, list): raise ValueError("统计响应缺少d数组,不能填成零流量") result = [] for row in rows: match = re.fullmatch(r"/Date\((-?\d+)(?:[+-]\d{4})?\)/", row["Date"]) if not match: raise ValueError("需核对实际日期格式") date = datetime.fromtimestamp(int(match[1]) / 1000, tz=timezone.utc) result.append({"date_utc": date.isoformat(), "clicks": row["Clicks"], "impressions": row["Impressions"]}) return result

用上面的教学JSON,可读出15次点击、100次展示及UTC时间。实际调用时,先核对HTTP状态与JSON结构;401/403、HTML错误页或缺字段不能转成d:[]。合法空数组可以表示这次统计没有记录,仍需保留请求站点与范围,不擅自填成网站所有流量为零。

提交网址是另一种返回,不能复用统计解析

SubmitUrl用于写入提交,官方JSON样例使用POST,参数在JSON正文:

POST https://ssl.bing.com/webmaster/api.svc/json/SubmitUrl?apikey=YOUR_API_KEY Content-Type: application/json; charset=utf-8 {"siteUrl":"https://example.com/","url":"https://example.com/products/lamp/"}

成功响应示例是{"d":null}。它与统计方法的d数组不同,不应该送进上面的traffic_rows函数。这里没有曝光点击可取,也不能把null解释成零流量、失败或已经收录。

真实切换时,先按原授权方式及当前额度核只读调用,再由有权限的维护者受控提交一条实际页面,保留状态和返回。本文的请求只作写法教学,没有提交这些示例地址,也没有操作用户Bing账户。

报表与提交,成功结果形状不同的原创教学示意
原创教学示意:报表结果的d数组含Clicks、Impressions和Date,SubmitUrl的成功响应示例则是d:null。两种返回结构要分别处理,空响应不能当成零流量或已经收录。

切换原任务入口:范围、授权与失败必须保留

Microsoft的当前API首页已列明SOAP、POX退役和REST迁移要求。范围是Bing Webmaster Tools,不能推广成Bing Ads或所有SOAP接口都停用。

让维护者找自动提交URL、拉取曝光点击、生成报表的实际脚本,再核计划任务运行哪份文件。搜索soap、pox和XML解析是线索;判断仍以当前调用路径及日志为准。

SOAP与POX都使用XML格式。JSON则是另一种数据格式,字段和外层结构不同。路径中还带api.svc,不代表仍是SOAP:官方JSON示例本身就用api.svc/json。

同一主机,路径对应不同协议的原创教学示意
原创教学示意:分别核对SOAP/POX与JSON的路径及请求格式;仅凭api.svc名称,不能判断仍在使用旧协议。这里讨论Bing站长工具,不包含Microsoft广告API。

保留已有授权方式,切换原计划任务

Bing支持OAuth与API Key,请求形式按对应官方指南维护,不把两种认证混成一份请求,也不在日志或工单公开凭据。

手动跑通的新文件,如果定时任务仍指向旧文件,第二天仍会失败。维护者应核任务入口、运行账号与输出位置;让新报告进入原来使用它的报表或告警流程,确认下游报表或告警能继续读取新数据。

保留一条当前成功记录和明确失败报警。只读统计正常、受控提交正常、计划任务使用新入口,才算这条调用链完成迁移。若还有空报表,继续找哪一步缺记录,不把所有空值填成零。

要从整体SEO工作判断这个故障的优先级,可以回到Google SEO学习路径了解监测与内容工作的关系;需要梳理站长工具接入,可向跨境YOUNG提供脱敏调用路径、报错和期望的报告字段。

常见问题

URL带api.svc,说明还在用SOAP吗?

不能。官方JSON样例也使用api.svc/json,应核后面的协议路径、请求格式和实际调用。

换成JSON后返回200,算完成了吗?

还要确认数据被正确解析,并进入原报告;写接口也要按自己的返回结构检查。定时任务必须运行新入口。

SubmitUrl成功,就代表Bing已经收录吗?

不代表。提交与后续抓取、索引是不同阶段,接口返回只能用于检查本次提交。

我专注 Google SEO、独立站增长与 AI 工作流,实践覆盖 WordPress 外贸 B2B 询盘站和 Shopify DTC 品牌站。从关键词研究、网站架构到内容与技术优化,我关注每一步怎样影响流量、询盘和购买。

本站分享我的项目方法与复盘,说明为什么这样做、具体怎样执行,以及如何判断改动是否有效。

雨果跨境观察员 · 公众号、抖音、小红书同名账号:跨境YOUNG。

学习与查找

从入门开始,或回到问题目录:

关于跨境YOUNG

跨境YOUNG整理WordPress建站、Google SEO与AI SEO / GEO方法,并提供建站、代运营和顾问服务。

需要有人持续推进SEO?

网站已上线,但页面、内容、技术、内链和月度数据没有持续推进?可先诊断范围与优先级,再按月执行与复盘。

最具性价比的服务器

Hostinger 适合预算有限的新站和中小企业 WordPress 网站,托管、备份与基础性能配置比较完整。通过专属链接可享 20% 折扣,购买前再核对机房位置和续费价格。

专属链接含 20% 折扣;跨境YOUNG可能获得佣金,不会增加你的购买成本。