API 文档

在你的应用程序中使用可靠、低延迟的端点。

PUB

公共工具

无需账号的小型可靠接口:时间、地址、国家、汇率与哈希。

GET /v1/public/time
GET /v1/public/timestamp
GET /v1/public/ip
GET /v1/public/geo
GET /v1/public/fx
GET /v1/public/hash
端点: 6
范围: 公开
ME

账号

令牌属于谁,以及它能做什么。

GET /v1/account/me
GET /v1/account/sessions
POST /v1/account/sessions/revoke
POST /v1/account/sessions/revoke-all
POST /v1/account/profile
端点: 5
范围: Bearer
DNS

DNS

认领域名、证明控制权,然后管理解析记录。

GET /v1/dns/zones
POST /v1/dns/zones
GET /v1/dns/zones/{zone}
POST /v1/dns/zones/{zone}/verify
DELETE /v1/dns/zones/{zone}
GET /v1/dns/zones/{zone}/records
POST /v1/dns/zones/{zone}/records
GET /v1/dns/zones/{zone}/records/{id}
PATCH /v1/dns/zones/{zone}/records/{id}
DELETE /v1/dns/zones/{zone}/records/{id}
端点: 10
范围: Bearer
KEY

凭据

凭据工具背后的私有凭据库。

GET /v1/cred
POST /v1/cred
端点: 2
范围: Bearer
FILE

文件

个人文件存储:列出、上传、编辑、分享与删除。

GET /v1/files
GET /v1/files/{id}
GET /v1/files/download
POST /v1/files/upload
POST /v1/files/update
POST /v1/files/rename
POST /v1/files/delete
POST /v1/files/upload-chunk
POST /v1/files/upload-finalize
端点: 9
范围: Bearer
API

CDN

你分享文件的边缘缓存与流量。

GET /v1/cdn/stats
POST /v1/cdn/config
POST /v1/cdn/purge
端点: 3
范围: Bearer
API

短信转发

从手机转发过来的消息,以及放行它的密钥。

GET /v1/sms/messages
GET /v1/sms/keys
POST /v1/sms/keys
DELETE /v1/sms/keys
端点: 4
范围: Bearer
API

静态站点

上传一个 zip,就是一个站点。

GET /v1/sites
POST /v1/sites/deploy
POST /v1/sites/delete
端点: 3
范围: Bearer
API

部署

你已部署的表单、Webhook 与短链接端点。

GET /v1/deployments
POST /v1/deployments/toggle
POST /v1/deployments/delete
端点: 3
范围: Bearer
API

域名

你的域名组合及其注册信息。

GET /v1/domains
POST /v1/domains/whois-sync
端点: 2
范围: Bearer
PKG

软件包

发布版本,并读取其版本与下载量。

GET /v1/packages
GET /v1/packages/{slug}
POST /v1/packages/publish
POST /v1/packages/update
POST /v1/packages/delete
端点: 5
范围: Bearer
WHO

WHOIS

域名注册信息,带缓存并与域名工具共用。

GET /v1/whois
端点: 1
范围: Bearer

开始使用

时间、IP 地址及汇率等公共端点均可免费使用,无需身份验证。

位于 /v1 的 DNS 管理 API 需要来自 账户 → API 密钥 的 Bearer 令牌。令牌只能访问其拥有者已验证的区域。

公共端点

fetch('https://api.c.nf/v1/public/time')
  .then(response => response.json())
  .then(data => console.log(data.data.iso8601));

需要身份验证的 DNS v1 端点

fetch('https://api.c.nf/v1/dns/zones', {
  headers: { 'Authorization': 'Bearer cnf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }
})
  .then(r => r.json())
  .then(data => console.log(data.data.zones));

面向 AI 代理

把代理指向 /v1/ai,那是一份可直接粘进提示词的说明;/v1/ai?format=json 则把同样的接口给成工具定义。/v1/openapi.json 是完整的 OpenAPI 3.1 契约,/llms.txt 是给爬虫看的索引。四者都由与本页相同的路由表生成,因此不会描述不存在的接口。