API 빠른 시작
첫 API 호출을 위해 이 가이드를 사용하세요. 전체 엔드포인트는 v1 API를 참고하세요.
사전 준비
섹션 제목: “사전 준비”- 활성 구독이 있는 Newsfork 계정
- 계정 대시보드 또는 온보딩 이메일의 API 키
전체 API 키는 지원 티켓, 채팅, 공개 저장소에 공유하지 마세요.
Base URL
섹션 제목: “Base URL”통합에 사용할 base URL은 온보딩 자료에 안내됩니다. production 또는 sandbox URL이 필요하면 hello@newsfork.com으로 문의하세요.
Authorization 헤더에 API 키를 전달합니다:
curl -sS \ -H "Authorization: Bearer YOUR_API_KEY" \ "https://YOUR_BASE_URL/health"YOUR_API_KEY와 YOUR_BASE_URL을 계정에서 받은 값으로 바꾸세요.
첫 요청
섹션 제목: “첫 요청”헬스 체크
섹션 제목: “헬스 체크”curl -sS \ -H "Authorization: Bearer YOUR_API_KEY" \ "https://YOUR_BASE_URL/health"시드 목록
섹션 제목: “시드 목록”curl -sS \ -H "Authorization: Bearer YOUR_API_KEY" \ "https://YOUR_BASE_URL/api/v1/seeds"쿼리 파라미터와 응답 필드는 Seeds API를 참고하세요.
오류 처리
섹션 제목: “오류 처리”| HTTP 상태 | 의미 |
|---|---|
401 | API 키 누락 또는 잘못됨 |
403 | 키는 유효하나 해당 리소스 권한 없음 |
429 | Rate limit 초과 — 백오프 후 재시도 |
5xx | 서버 오류 — 지수 백오프로 재시도 |
Rate limit
섹션 제목: “Rate limit”플랜에 따라 limit이 다릅니다. 요금 또는 영업 문의를 참고하세요.