문서 → Markdown 변환 REST API & SDK 생성기
OpenAPI 3.0.3 POST /api/v1/conversions용 무인증 cURL, TypeScript, Python, Node.js 클라이언트를 생성합니다.
공개 v1 리소스: POST /api/v1/conversions (멀티파트 Form-Data · 최대 10 MB · 무인증 REST API)
무상태 인메모리 API — 업로드된 파일은 변환 직후 즉시 폐기됩니다
Swagger UI 열기 (/swagger)
RESTful v1 리소스 & 응답 사양
ToMarkdown은 세 가지 OpenAPI 3.0.3 리소스(/openapi.json)를 제공합니다:
POST /api/v1/conversions(createConversion), GET /api/v1/formats(listFormats), GET /api/v1/health(getHealth).
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 15
X-RateLimit-Remaining: 14
{
"filename": "architecture-spec.pdf",
"media_type": "application/pdf",
"size_bytes": 248910,
"token_count": 1842,
"markdown": "# Architecture Specification\n\nConverted Markdown content..."
}
- 콘텐츠 협상:
Conversion객체를 받으려면Accept: application/json(?format=json)을, 직접.md다운로드 스트림을 받으려면Accept: text/markdown(?format=markdown)을 전달하세요. - 할당량 & 오류 응답: 최대 10 MB의 문서·스프레드시트·마크업 확장자 22종을 지원하며(IP당
15 req/min),400,413,415(이미지/SVG),429발생 시 구조화된{ "error": { "code", "message", "status" } }를 반환합니다.
자주 묻는 질문
POST /api/v1/conversions 호출 시 API 키가 필요한가요?
아니요. 최대 10 MB의 공개 문서 변환(.pdf, .docx, .xlsx, .ods, .numbers, .html, .xml, .csv)은 무료이며 API 키가 필요하지 않습니다. 이미지 및 SVG 파일은 거부되며(415), 서비스 가용성 보호를 위해 IP별 속도 제한(15 req/min)이 적용됩니다.
POST /api/v1/conversions는 어떤 JSON 스키마를 반환하나요?
Accept: application/json 또는 ?format=json을 지정하면 POST /api/v1/conversions는 { filename, media_type, size_bytes, token_count, markdown }을 반환하며, markdown에는 추출된 GFM이, token_count에는 추정 토큰 수가 담깁니다.