跳到导航

公众号链接里的 mid、idx、sn 是什么?短链接必须转成长链吗?

公众号长链接里的 __biz 对应账号,mid 对应一次群发,idx 是文章在这次群发里的位置,sn 是链接携带的校验参数。查正文或互动时,直接传收到的完整链接,不要改参数;公开短链接也能直接用。整理链接清单时一定保留 idx:__biz + mid + idx 一起才确定一篇文章。

__biz、mid、idx、sn 什么时候会用到?

参数整理文章时的作用
__biz长链接中的账号成分;查账号历史时仍使用 username
mid区分消息/群发,原样保存
idx区分同次群发中的文章,从1开始
sn随原链接一起保存,取文时直接传完整URL

最容易弄丢的是 idx。例如同一个 __biz、同一个 mid,一条链接是 idx=1,另一条是 idx=2,两条链接是同一次群发里的两篇不同文章。做资料表时两条都留下,不能只按公众号或 mid 去重。

不要把 mid 手工改成别的接口字段名。读文章时传完整 url;查账号历史时,从文章详情取得 user_name。

同事发来一批链接,怎么整理?

先保留收到的原始清单,再按链接形式分别处理:

拿到的链接怎么做
/s/… 短链接直接用于取文或统计,保留原样
带 __biz、mid、idx 的长链接保留完整参数,按文章身份归类
三个身份参数相同、附加参数不同放进同一候选组,核对差别后选择要用的原链接
idx 不同分成不同文章
链接被截断、复制成了HTML文本向提供者补要完整公开分享链接,不自行猜参数

短链和长链看起来像同一篇时,先各自保留,等拿到可核对的文章信息再关联。标题相同可以作为线索,不能单凭标题删掉其中一条。

收到带额外来源参数的链接时,先按 __biz、mid 和 idx 放进同一候选组,保留每条原 URL。读取文章后,用返回的标题和来源核对分组。

大批量时,用本地清单先整理

下面的 audit_links.py 一次检查 1–200 条链接,不访问文章,成功后生成两个文件:

  • input-urls.json:原始输入,方便回查。
  • link-audit.json:长短链、长链身份参数、同身份候选组。

same_long_identity_groups 里的 input_indices 是输入 JSON 数组中从 0 开始的位置。每条原 URL 都保留;短链的身份保持未解析,需要时再读取文章核对。link-audit.json 只说明链接结构,文章能否读取以实际读取结果为准。

准备好清单后,选需要的文章进入正文读取或互动统计。想继续看账号历史,则走文章到账号定位。调用计费见价格页。

附:离线整理脚本

把实际链接保存为 article-links.json 里的 JSON 数组,格式如下:

[
"https://mp.weixin.qq.com/s?__biz=EXAMPLE_ACCOUNT&mid=123456789&idx=2&sn=EXAMPLE_CHECK_VALUE",
"https://mp.weixin.qq.com/s/example-short-token"
]

把后面的脚本保存为 audit_links.py,然后运行:

python3 audit_links.py article-links.json link-review

audit_links.py 检查公开分享链接的结构,保留输入字节和原 URL;遇到复制错误或不明确的身份参数时,audit_links.py 停止并提示需要核对的条目。每次运行用新的输出目录名,已有结果会保留。

import hashlib,json,pathlib,re,sys
from urllib.parse import parse_qs,urlsplit
source,target=map(pathlib.Path,sys.argv[1:]);original=source.read_bytes();urls=json.loads(original)
if not isinstance(urls,list) or not 1<=len(urls)<=200:raise ValueError('Provide 1..200 public article URLs')
rows=[];groups={}
for url in urls:
if not isinstance(url,str) or not url or any(c.isspace() or ord(c)<32 or ord(c)==127 for c in url):raise ValueError('Use an intact public URL without whitespace/control characters')
parsed=urlsplit(url)
if parsed.scheme not in ('http','https') or parsed.hostname!='mp.weixin.qq.com' or parsed.username is not None or parsed.password is not None or parsed.port not in (None,80,443):raise ValueError('Expected a WeChat article host without embedded credentials')
query=parse_qs(parsed.query,keep_blank_values=True)
if any(k.startswith('amp;') for k in query):raise ValueError('Copy the actual URL, not HTML-escaped markup')
if any(k.lower() in ('pass_ticket','key','uin','ticket','access_token') for k in query):raise ValueError('Use a public share URL without browser-session parameters')
for key in ['__biz','mid','idx','sn']:
if key in query and (len(query[key])!=1 or not query[key][0] or any(c.isspace() or ord(c)<32 or ord(c)==127 for c in query[key][0])):raise ValueError('Ambiguous, blank or malformed article component: '+key)
if parsed.path=='/s':
if not all(k in query for k in ['__biz','mid','idx']):raise ValueError('Long-link identity needs __biz, mid and idx')
biz,mid,idx=(query[k][0] for k in ['__biz','mid','idx'])
if not re.fullmatch(r'[0-9]+',mid) or int(mid)<1 or not re.fullmatch(r'[0-9]+',idx) or int(idx)<1:raise ValueError('mid/idx must be original positive ASCII digit strings')
identity=[biz,mid,idx]
row={'url':url,'kind':'long','biz':biz,'mid':mid,'idx':idx,'sn_present':'sn' in query,'identity':identity,
'position':'headline' if int(idx)==1 else 'secondary'}
groups.setdefault(json.dumps(identity,ensure_ascii=False),[]).append(len(rows))
elif parsed.path.startswith('/s/') and parsed.path[3:] and '/' not in parsed.path[3:]:
row={'url':url,'kind':'short','biz':None,'mid':None,'idx':None,'sn_present':'sn' in query,'identity':None,'position':'not_derived_from_short_link'}
else:raise ValueError('Expected /s with long parameters or one /s/ article token')
rows.append(row)
target.mkdir()
(target/'input-urls.json').write_bytes(original)
(target/'link-audit.json').write_text(json.dumps({'links':rows,
'same_long_identity_groups':[{'identity':json.loads(k),'input_indices':v} for k,v in groups.items() if len(v)>1],
'input_sha256':hashlib.sha256(original).hexdigest(),'short_long_aliases_resolved':False,
'network_requests':0,'article_availability_verified':False},ensure_ascii=False,indent=2),encoding='utf-8')
print(json.dumps({'links':len(rows),'long_links':sum(r['kind']=='long' for r in rows),'short_links':sum(r['kind']=='short' for r in rows),'network_requests':0}))