# Cardnews API

HTML 템플릿과 headless Chromium으로 카드뉴스 PNG를 렌더링하는 API입니다.
인증: 렌더 요청에는 Authorization: Bearer <API_KEY>를 사용합니다. 탐색 문서는 공개입니다.

## API 문서

- [퀵스타트](https://api.cardnews.dev/docs/quickstart.md)
- [Renders API](https://api.cardnews.dev/docs/renders.md)
- [템플릿 카탈로그](https://api.cardnews.dev/docs/templates.md)
- [에러 코드](https://api.cardnews.dev/docs/errors.md)

## 활성 템플릿

- [bigfact](https://api.cardnews.dev/v1/templates/bigfact/llms.txt): 숫자 하나가 화면을 채우는 통계·팩트형. 놀라운 수치를 던지고 그 의미를 설명하는 구조라 공유가 잘 된다.
- [clean](https://api.cardnews.dev/v1/templates/clean/llms.txt): 클린 에디토리얼 레이아웃으로 개발·비즈니스 정보를 또렷하게 전달하는 범용 템플릿.
- [lightsoft-class](https://api.cardnews.dev/v1/templates/lightsoft-class/llms.txt): 비개발자 대상 바이브코딩 학습 내용을 단계별로 설명하는 Lightsoft 카드뉴스 템플릿.
- [listicle](https://api.cardnews.dev/v1/templates/listicle/llms.txt): 번호가 주인공인 목록형 카드뉴스. "알아두면 좋은 5가지" 처럼 항목을 하나씩 넘기며 읽는 구조라 저장률이 높다.
- [magazine](https://api.cardnews.dev/v1/templates/magazine/llms.txt): 잡지 지면처럼 사진과 세리프 타이포를 쓰는 에디토리얼형. 브랜드에 격을 더하고 싶은 인터뷰·에세이·큐레이션에 맞는다.
- [photo-card](https://api.cardnews.dev/v1/templates/photo-card/llms.txt): 사진을 화면 가득 사용해 여행·음식·라이프스타일 콘텐츠를 선명하게 보여주는 템플릿.