LEGNASEND / DEVELOPERS

开发者与 API 文档

从启用服务到编写客户端：接口、鉴权、字段、示例、限制、错误和排障都在这里。这是 LegnaSend 客户端开放 API 的完整离线文档；PHP 下载站不代理、不执行这些接口。

接口与调用示例

服务状态、工作区、文件、上传、发送任务、设置、审计；含 cURL、JavaScript、Python。

鉴权与权限

Bearer 密钥、TLS/CORS、一次性秘密、生命周期、权限范围与重放规则。

参数、速率与错误

字段容量见参数表；请求频率、并发、429 与错误码见完整集成 API。

调试与恢复

应用内 explorer、请求记录、保留策略、续传与清理证明；区分实现状态和设备验收。

快速接入

在应用 API 页面启用服务，选择权限与工作区，创建密钥。
读取应用显示的实际监听协议、地址及端口；HTTPS 需正确信任设备证书，必要时提供客户端证书。
以 Bearer 密钥调用 /status 和 /capabilities，再读取工作区及其 generation。
按能力和权限执行操作；保留请求 ID，区分限流、版本过期与结果未知，不盲目重复修改。

shell

curl "$BASE/api/legnasend/v1/integration/status" \
  -H "Authorization: Bearer $TOKEN"

curl "$BASE/api/legnasend/v1/integration/capabilities" \
  -H "Authorization: Bearer $TOKEN"

BASE 是运行 LegnaSend 客户端服务的实际地址（协议、HOST 和 PORT），不是下载站域名；TOKEN 是你在应用内创建的密钥，示例不含运行凭据。

OpenAPI 下载

English · OpenAPI 3.1 简体中文 · OpenAPI 3.1 繁體中文 · OpenAPI 3.1 香港繁體 · OpenAPI 3.1

静态快照描述需要鉴权的模式；实时能力与匿名策略以实际服务为准。

排障顺序

先检查实际监听地址和 TLS 信任，再检查 API 是否启用、密钥状态／权限、工作区 generation。使用应用内请求控制台查看状态码与请求 ID；429 按响应退避，冲突／取消／未知结果按各接口合同处理。不要把密钥、密码或文件正文写入日志。

完整错误合同与示例