永盈科技 YY.la返回域名控制台

API 密钥管理

让外部程序安全调用域名、DNS、缓存和已授权的管理功能。密钥始终受账户实时域名权限约束。

登录后管理密钥

使用面板现有账号;此页面只在内存保留登录会话,刷新后需重新登录。

调用示例

Header 支持 Authorization: Bearer 或 X-API-Key。操作路径与面板保持一致,普通账户仅操作自己有权限的域名。

export YYCF_API_KEY='替换为你的密钥'
# 查看可操作域名(结果中 id 为 Zone ID)
curl https://cf.yy.la/api/zones -H "Authorization: Bearer $YYCF_API_KEY"
# 添加域名
curl https://cf.yy.la/api/zones -H "Authorization: Bearer $YYCF_API_KEY" \
  -H 'Content-Type: application/json' -d '{"domain":"example.com"}'
# 修改现有记录的 IP
curl -X PUT https://cf.yy.la/api/zones/ZONE_ID/dns/RECORD_ID \
  -H "Authorization: Bearer $YYCF_API_KEY" -H 'Content-Type: application/json' \
  -d '{"type":"A","name":"www.example.com","content":"192.0.2.10","ttl":1,"proxied":false}'

401:密钥无效或过期;403:无操作/域名权限;429:请求过快,请按 Retry-After 重试。所有调用记录密钥 ID、接口及结果,不记录密钥正文。