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 係畀爬蟲睇嘅索引。四者都由同本頁一樣嘅路由表生成,所以唔會描述唔存在嘅端點。