API 문서
애플리케이션에서 안정적이고 지연 시간이 짧은 엔드포인트를 사용하세요.
공개 유틸리티
계정 없이 쓰는 작고 안정적인 엔드포인트. 시간, 주소, 국가, 환율, 해시.
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
적용 범위:
공개
계정
토큰이 누구의 것이고 무엇을 할 수 있는지.
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
도메인을 신청하고 통제권을 증명한 뒤 레코드를 관리합니다.
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
자격 증명
자격 증명 도구 뒤의 비공개 보관소.
GET /v1/cred
POST /v1/cred
엔드포인트:
2
적용 범위:
Bearer
파일
개인 파일 저장소. 목록, 업로드, 편집, 공유, 삭제.
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
CDN
공유한 파일의 엣지 캐시와 트래픽.
GET /v1/cdn/stats
POST /v1/cdn/config
POST /v1/cdn/purge
엔드포인트:
3
적용 범위:
Bearer
SMS 전달
휴대폰에서 전달된 메시지와 이를 허용하는 키.
GET /v1/sms/messages
GET /v1/sms/keys
POST /v1/sms/keys
DELETE /v1/sms/keys
엔드포인트:
4
적용 범위:
Bearer
정적 사이트
zip을 올리면 사이트가 됩니다.
GET /v1/sites
POST /v1/sites/deploy
POST /v1/sites/delete
엔드포인트:
3
적용 범위:
Bearer
배포
배포한 폼, 웹훅, 단축 링크 엔드포인트.
GET /v1/deployments
POST /v1/deployments/toggle
POST /v1/deployments/delete
엔드포인트:
3
적용 범위:
Bearer
도메인
도메인 포트폴리오와 등록 정보.
GET /v1/domains
POST /v1/domains/whois-sync
엔드포인트:
2
적용 범위:
Bearer
패키지
릴리스를 게시하고 버전과 다운로드 수를 조회합니다.
GET /v1/packages
GET /v1/packages/{slug}
POST /v1/packages/publish
POST /v1/packages/update
POST /v1/packages/delete
엔드포인트:
5
적용 범위:
Bearer
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는 크롤러용 안내입니다. 넷 다 이 페이지와 같은 라우팅 표에서 생성되므로 없는 엔드포인트를 설명할 수 없습니다.