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

SMS 전달

휴대폰에서 전달된 메시지와 이를 허용하는 키.

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

배포

배포한 폼, 웹훅, 단축 링크 엔드포인트.

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는 크롤러용 안내입니다. 넷 다 이 페이지와 같은 라우팅 표에서 생성되므로 없는 엔드포인트를 설명할 수 없습니다.