Mastodon文档中关系断绝事件实体属性的修正说明

在Mastodon社交平台的开发文档中，关于关系断绝事件(RelationshipSeveranceEvent)实体的描述存在一处需要修正的技术细节。本文将从技术角度详细分析这一问题，并说明正确的实现方式。

问题背景

Mastodon平台在处理用户关系断绝事件时，会生成一个包含相关统计信息的实体对象。根据官方文档描述，该实体应包含一个名为relationships_count的属性字段，用于表示受影响的关系数量。

然而，在实际的API响应数据中，开发者发现平台返回的是两个独立的统计字段：followers_count和following_count，分别表示被影响的关注者数量和关注对象数量。这与文档描述存在不一致。

技术细节分析

通过实际测试，当用户在Mastodon实例上对特定域名实施屏蔽操作时，服务器返回的事件对象结构如下：

{
    "id": "2",
    "type": "user_domain_block",
    "purged": false,
    "target_name": "example.domain",
    "followers_count": 2,
    "following_count": 0,
    "created_at": "2024-11-13T11:31:15.302Z"
}

从技术实现角度来看，将关系统计拆分为两个独立字段具有以下优势：

1. 数据粒度更细：区分关注者和被关注者的数量，提供更详细的关系变更信息
2. 语义更明确：直接表明是哪种类型的关系受到影响
3. 兼容性更好：便于客户端分别处理不同类型的统计信息

修正建议

基于实际实现情况，建议文档进行以下修正：

1. 移除relationships_count属性的描述
2. 新增followers_count属性的说明，解释其表示因该事件而断绝的关注者数量
3. 新增following_count属性的说明，解释其表示因该事件而断绝的关注对象数量

这种修正能够使文档与实际API行为保持一致，同时为开发者提供更准确的技术参考。

对开发者的影响

对于正在使用Mastodon API的开发者，需要注意以下几点：

1. 实际API返回的关系统计字段与文档描述不同
2. 需要同时处理followers_count和following_count两个字段
3. 这两个字段的值可能同时存在，需要分别处理其业务逻辑

这一修正将帮助开发者更准确地理解和使用Mastodon的关系断绝事件API，避免因文档与实际实现不一致而导致的功能异常。