FacePick API 文档
当前本地集成契约；不是旧版v1服务。Cookie控制台与Bearer应用接口分开鉴权。不要在此页输入密钥。
应用身份
GET /api/developer/whoamiAuthorization: Bearer（应用私有API Key）；POST使用Content-Type: application/json。网页登录Cookie不能代替应用Key。
请求参数
无需请求体。
返回结果
data.applicationId、data.developerId：当前Key所属应用与租户。
成功：{data, requestId}；失败：{code, message, requestId, details?}。HTTP失败不要当作业务成功。
错误处理
401 UNAUTHENTICATED：密钥无效或已撤销。 服务内部错误返回安全错误，不显示数据库诊断。记录requestId用于排查。
服务端 JavaScript 示例
先下载客户端，在私有进程配置环境变量。许可使用会扣次；只用自己的有效许可与允许范围。FACEPIC_USE_IDEMPOTENCY_KEY须预先保存，网络失败重试不能换新值。
import {FacePickClient} from './facepick-client.mjs';
const client = new FacePickClient({
baseUrl: process.env.FACEPIC_BASE_URL ?? 'http://127.0.0.1:3110',
apiKey: process.env.FACEPIC_API_KEY,
});
try {
const result = await client.identity();
console.log(JSON.stringify({requestId: result.requestId}));
} catch (error) {
console.error(JSON.stringify({code: error.code ?? 'CLIENT_ERROR', status: error.status ?? 0, requestId: error.requestId ?? null}));
process.exitCode = 1;
}