Posty5 提供 REST、JavaScript/TypeScript SDK、.NET 包和 n8n 节点四条集成路径。请先创建名称清楚的密钥。
创建并命名密钥
Developer 账户可在设置中打开 API Keys and Integrations，并按应用或任务为密钥命名。
- 创建并命名密钥
- 保护并轮换密钥
- 认证请求
认证请求
通过 X-API-Key header 发送密钥。SDK 默认使用 https://api.posty5.com；不要把密钥放入浏览器代码、公开仓库或截图。
curl https://api.posty5.com/api/short-link \
-H "X-API-Key: $POSTY5_API_KEY"选择集成方式
REST 适合直接控制 HTTP，SDK 适合类型化 Node.js，.NET 适合 C#，n8n 适合可视化流程。JavaScript workspace 有八个已验证包。
使用 SDK 包
@posty5/core@posty5/short-link@posty5/qr-code@posty5/html-hosting@posty5/html-hosting-variables@posty5/html-hosting-form-submission@posty5/social-publisher-workspace@posty5/social-publisher-post
保护并轮换密钥
密钥只保存在服务器端，不同应用和环境使用不同密钥，也不要记录密钥值。轮换时先创建并测试新密钥，再删除旧密钥。
排查连接
认证失败时检查 base URL、X-API-Key 拼写和密钥状态。403 可能表示操作不允许，validation error 需要修正字段。
排查连接
认证请求
通过 X-API-Key header 发送密钥。SDK 默认使用 https://api.posty5.com；不要把密钥放入浏览器代码、公开仓库或截图。
选择集成方式
REST 适合直接控制 HTTP，SDK 适合类型化 Node.js，.NET 适合 C#，n8n 适合可视化流程。JavaScript workspace 有八个已验证包。
保护并轮换密钥
密钥只保存在服务器端，不同应用和环境使用不同密钥，也不要记录密钥值。轮换时先创建并测试新密钥，再删除旧密钥。
排查连接
认证失败时检查 base URL、X-API-Key 拼写和密钥状态。403 可能表示操作不允许，validation error 需要修正字段。
