<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[开发者与 API]]></title><description><![CDATA[Flutter客户端、NAS/云端接口、签名协议、插件与开发联调。]]></description><link>https://www.apuos.cn/community/category/11</link><generator>RSS for Node</generator><lastBuildDate>Fri, 13 Nov 2026 13:34:04 GMT</lastBuildDate><atom:link href="https://www.apuos.cn/community/category/11.rss" rel="self" type="application/rss+xml"/><pubDate>Fri, 16 Oct 2026 04:40:43 GMT</pubDate><ttl>60</ttl><item><title><![CDATA[开发者接入入口与最小联调清单]]></title><description><![CDATA[先选择正确的服务边界
官网客户端开发指南说明云端发现/配对、NAS HTTP 和 WebRTC 直传协议。云端只处理连接协调，文件内容与文件信息不上传到发现服务器。NAS 会话、云端配对 bearer 与旧互传 peer claimToken 不可互换。
推荐的联调顺序

查询目标 NAS 的运行版本和 capabilities，核对所需套件、数据卷和实际账号权限。
先在可信局域网完成登录、目录浏览和隔离文件上传；记录权威received断点与最终receipt。
再实现签名配对、NAS明确审批、SDP/ICE验证和实际DTLS证书核对，文件走直连通道。
覆盖断网、过期重新登录、进程重启、错误摘要、同名冲突和提交结果不确定等情况。

怎样报告接口问题
提供方法、路径、版本、脱敏后的请求/响应与错误码。请使用合成小文件和最小代码示例，保留关键字段类型、字节数、偏移和时间单位。不要上传真实NAS密码、Bearer、PIN、私钥或用户原始文件。
新版持久上传接口与早期Flutter单文件原型的能力不同，文档存在不代表旧客户端已经接入。协议描述、便携测试、真实Linux运行、生产账号文件权限与公网NAT条件要分别验证。社区可讨论接口设计和复现过程，确定缺陷后在Bug板块保留独立记录。
发布前检查
请先搜索已有主题，一帖讨论一个主要问题。截图和日志请遮蔽密码、访问令牌、配对码、许可证私钥、个人文件和设备序列号。社区账号独立于 NAS 账号。涉及存储操作时先备份重要数据，按照实际设备与版本核对说明。
]]></description><link>https://www.apuos.cn/community/topic/13/开发者接入入口与最小联调清单</link><guid isPermaLink="true">https://www.apuos.cn/community/topic/13/开发者接入入口与最小联调清单</guid><dc:creator><![CDATA[apuos-admin]]></dc:creator><pubDate>Fri, 16 Oct 2026 04:40:43 GMT</pubDate></item></channel></rss>