공개 API (/v1)
OpenAPI 스펙
키 없이 받을 수 있는 OpenAPI 3.1 스펙 — GPT Actions·함수 호출·코드 생성기에 그대로 가져오세요.
스펙 받기#
GET
/v1/openapi.jsonOpenAPI 3.1 스펙이에요. 키 없이 받을 수 있고, GPT Actions·함수 호출 도구에 그대로 가져올 수 있어요: https://api.esimoa.com/v1/openapi.json
shell
curl https://api.esimoa.com/v1/openapi.json -o esimoa-openapi.json참고
스펙은 이 문서와 같은 계약이에요. 응답 필드는 추가만 되고 이름·의미는 바뀌지 않아요. 스펙은 1시간 캐시돼요.
GPT Actions 에서 쓰기#
GPT 만들기(Actions)로 연결하려면 스키마를 URL 에서 가져오세요: https://api.esimoa.com/v1/openapi.json — 인증은 API 키, 사용자 지정 헤더 이름 X-API-Key 로 설정해요.
클라이언트 코드 생성#
표준 OpenAPI 도구로 타입이나 클라이언트 코드를 만들 수 있어요.
shell
# TypeScript types
npx openapi-typescript https://api.esimoa.com/v1/openapi.json -o esimoa.d.ts
# Any language (Python, Go, Java, …)
npx @openapitools/openapi-generator-cli generate \
-i https://api.esimoa.com/v1/openapi.json -g python -o ./esimoa-client