OpenAPI
OpenAPI YAML은 아래 경로에서 제공합니다.
https://api-docs.runmoa.ai/openapi.yaml사용 방법
섹션 제목: “사용 방법”curl -L https://api-docs.runmoa.ai/openapi.yamlOpenAPI 파일은 SDK 생성, API 검사 도구, AI 검색용 컨텍스트에 사용할 수 있습니다.
자료별 사용 목적
섹션 제목: “자료별 사용 목적”| 자료 | 용도 |
|---|---|
| 문서 페이지 | 사람이 읽는 설명, 흐름, 주의 사항 |
openapi.yaml | 엔드포인트 목록과 인증 방식의 기계 판독용 표현 |
llms.txt | AI 도구가 읽기 좋은 문서 지도 |
llms-full.txt | AI 도구에 바로 넣을 수 있는 압축 문서 본문 |
OpenAPI에는 외부 구현에서 사용하는 스토어프론트 API와 서버용 비공개 API만 포함합니다.
기본 서버와 GET 조회 스키마는 스토어프론트 기준입니다. 서버용 생성/수정은 각 operation의 servers와 ServerPrivateKey 인증을 따릅니다. 같은 경로라도 서버용 조회 응답까지 같다는 뜻은 아닙니다. 서버용 GET 조회는 상품 API, 콘텐츠 API를 함께 확인하세요. 필드 이름과 ID 의미는 공개 API 필드 이름을 공통으로 적용합니다.