本页对应「三、操作步骤」的 3.1，在同步配置文件中登记目标平台的接口地址、认证方式与重试策略，并用只读接口确认连通性与权限范围。返回上级：多平台同步。

前置条件

• 已从目标平台取得接口地址与访问令牌，令牌具备创建与查询内容的权限。
• 已确认平台接口的速率限制与单次请求大小上限。
• 配置文件目录为 /srv/axis/sync，凭据文件权限为 600。
• 已确认目标平台的接口版本与文档一致，避免按旧版字段配置。
• 已确认测试账号具备写入权限，且测试产生的记录可以删除。

操作步骤

1. 创建凭据文件与配置文件，凭据与配置分离：

install -d -m 750 /srv/axis/sync
umask 077 && printf 'SYNC_TOKEN=%s\n' "$SYNC_TOKEN" > /srv/axis/sync/.env
cat > /srv/axis/sync/platform.json <<'EOF'
{
  "endpoint": "https://api.example.com/v1/posts",
  "method": "POST",
  "timeout": 15,
  "retries": 2,
  "auth": "bearer"
}
EOF
jq . /srv/axis/sync/platform.json

2. 调用平台只读接口验证连通性与令牌有效性：

curl -sS -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Bearer $SYNC_TOKEN" \
  "https://api.example.com/v1/me"

3. 检查速率限制响应头，确定批量同步的并发与间隔：

curl -sS -D - -o /dev/null \
  -H "Authorization: Bearer $SYNC_TOKEN" \
  "https://api.example.com/v1/posts?limit=1" \
  | awk 'BEGIN{IGNORECASE=1} /^(x-ratelimit|retry-after):/'

4. 用测试内容发起一次写入，确认返回结构中包含可回查的 ID：

curl -sS -X POST "https://api.example.com/v1/posts" \
  -H "Authorization: Bearer $SYNC_TOKEN" \
  -H "Content-Type: application/json" \
  --data @/srv/axis/sync/payload.json | jq '{id, status}'

结果确认

• 只读接口返回 200，返回体中的账号信息与预期一致。
• 速率限制响应头能读到剩余配额与重置时间，可据此设置间隔。
• 写入接口返回 200 或 201，响应体包含唯一 ID，后续可按该 ID 回查。
• 使用错误令牌时返回 401，说明认证链路确实生效。

注意事项

• 令牌只通过环境变量读取，配置文件中不出现明文，日志中也要屏蔽请求头。
• 重试只针对超时与 5xx，4xx 重试没有意义，反而可能触发风控。
• 接口地址变更后先改配置并跑通单篇，再恢复批量任务。
• 令牌不要设置在命令行历史里，通过 read -s 或环境文件注入，命令结束后及时清空变量。
• 测试写入产生的记录要能删除，配置阶段就确认删除接口可用，否则测试数据会堆在目标平台。
• 平台接口版本号写进配置，升级时按版本灰度切换，不要直接改地址后全量重跑。

上一页多平台同步

下一页3.2 字段映射