stly

stly apis

On this page

This page is generated from the public contract. Descriptions are shown in the original Korean.

stly apis create#

API 생성

HTTP request: POST /api/apis
Authentication modes: Agent token, User session
Changes records: Yes
Input JSON (--input) required

Check the input JSON structure with stly schema apis create.

Options

Name	Type	Required	Description
`--input`	`string`	Yes	JSON 원문 파일 또는 stdin(-)
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `base_urls`, `created_at`, `description`, `handle`, `id`, `name`, `security`, `summary`, `updated_at`

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis create --input input.json

stly apis delete#

API 삭제

HTTP request: DELETE /api/apis/{id}
Authentication modes: Agent token, User session
Changes records: Yes
--if-match required

Arguments

id: ID

Options

Name	Type	Required	Description
`--if-match`	`string`	Yes	상세 GET에서 얻은 단일 strong ETag
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis delete 00000000-0000-0000-0000-000000000001 --if-match '"상세 GET의 ETag"'

stly apis get#

API 상세 조회

HTTP request: GET /api/apis/{id}
Authentication modes: Agent token, User session
Changes records: No

Arguments

id: ID

Options

Name	Type	Required	Description
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `base_urls`, `created_at`, `description`, `handle`, `id`, `name`, `security`, `summary`, `updated_at`

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis get 00000000-0000-0000-0000-000000000001

stly apis list#

API 목록 조회

HTTP request: GET /api/apis
Authentication modes: Agent token, User session
Changes records: No

Options

Name	Type	Required	Description
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `base_urls`, `created_at`, `description`, `handle`, `id`, `name`, `security`, `summary`, `updated_at`
`--handle`	`string`	No	Web 주소 이름 정확 일치 필터. 앞뒤 공백 제거·소문자 정규화 후 비교하며 결과는 최대 1건
`--page`	`string`	No	1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드
`--per-page`	`string`	No	1~500 정수, 생략 시 100
`--q`	`string`	No	name·summary·description 필드 중 하나의 대소문자 구분 리터럴 부분 일치 검색. 본문은 검색하지 않으며 정규식·와일드카드를 지원하지 않습니다
`--sort`	`string`	No	리소스 기본 필드명 또는 - 접두 역순만 허용

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis list --q "검색어"

stly apis service get#

API 제공 Service 조회

HTTP request: GET /api/apis/{api_id}/service
Authentication modes: Agent token, User session
Changes records: No

Arguments

id: ID

Options

Name	Type	Required	Description
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `api_id`, `service_id`, `updated_at`

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis service get 00000000-0000-0000-0000-000000000001

stly apis service update#

API 제공 Service 확정

HTTP request: PUT /api/apis/{api_id}/service
Authentication modes: Agent token, User session
Changes records: Yes
Input JSON (--input) required
--if-match required

Check the input JSON structure with stly schema apis service update.

Arguments

id: ID

Options

Name	Type	Required	Description
`--if-match`	`string`	Yes	상세 GET에서 얻은 단일 strong ETag
`--input`	`string`	Yes	JSON 원문 파일 또는 stdin(-)
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `api_id`, `service_id`, `updated_at`

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis service update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'

stly apis set-service#

API 제공 Service 선택 또는 미연결 확정

HTTP request: PUT /api/apis/{api_id}/service
Authentication modes: Agent token, User session
Changes records: Yes
--if-match required

Arguments

id: ID

Options

Name	Type	Required	Description
`--if-match`	`string`	Yes	상세 GET에서 얻은 단일 strong ETag
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `api_id`, `service_id`, `updated_at`
`--none`	`boolean`	No	제공 Service를 명시적으로 미연결
`--service`	`string`	No	제공 Service ID

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis set-service <id> --service <id> --if-match '"제공 Service GET의 ETag"'

stly apis systems#

API의 소속 System 조회

HTTP request: GET /api/apis/{id}/systems
Authentication modes: Agent token, User session
Changes records: No

Arguments

id: ID

Options

Name	Type	Required	Description
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `description`, `id`, `inclusion`, `kind`, `name`, `summary`
`--page`	`string`	No	1 이상 정수. page·per-page 중 하나라도 있으면 페이지 모드
`--per-page`	`string`	No	1~500 정수, 생략 시 100
`--q`	`string`	No	name 필드의 대소문자 구분 리터럴 부분 일치 검색. summary·description·본문은 검색하지 않으며 정규식·와일드카드를 지원하지 않습니다
`--scope`	`string`	No	direct 또는 recursive 구성 범위 Values: `direct`, `recursive`
`--sort`	`string`	No	리소스 기본 필드명 또는 - 접두 역순만 허용

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis systems 00000000-0000-0000-0000-000000000001 --q "검색어"

stly apis update#

API 수정

HTTP request: PUT /api/apis/{id}
Authentication modes: Agent token, User session
Changes records: Yes
Input JSON (--input) required
--if-match required

Check the input JSON structure with stly schema apis update.

Arguments

id: ID

Options

Name	Type	Required	Description
`--if-match`	`string`	Yes	상세 GET에서 얻은 단일 strong ETag
`--input`	`string`	Yes	JSON 원문 파일 또는 stdin(-)
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분 Values: `base_urls`, `created_at`, `description`, `handle`, `id`, `name`, `security`, `summary`, `updated_at`

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Example

stly apis update 00000000-0000-0000-0000-000000000001 --input input.json --if-match '"상세 GET의 ETag"'

stly apis validate#

API 생성·수정 후보 사전 검증(저장 없음)

HTTP request: --operation create POST /api/apis/validate, --operation update PUT /api/apis/{id}/validate
Authentication modes: Agent token, User session
Changes records: No
Input JSON (--input) required

Check the input JSON structure with stly schema apis validate --operation create|update.

Arguments

id: ID

Options

Name	Type	Required	Description
`--input`	`string`	Yes	JSON 원문 파일 또는 stdin(-)
`--operation`	`string`	Yes	검증할 작업 종류. 생성 후보는 create, 수정 후보는 update Values: `create`, `update`
`--fields`	`string`	No	응답 최상위 필드, 쉼표로 구분
`--if-match`	`string`	No	상세 GET에서 얻은 단일 strong ETag

Common options: --server, --env-file, --timeout, --auth-mode, --dry-run

Behavior

실제 서버를 호출해 입력·참조·중복·If-Match를 검사하며 저장하지 않습니다. 도메인 규칙은 서버가 판단합니다.
--operation create: 대상 id·If-Match 금지. update: 대상 id·단일 strong If-Match 필수, 부모 옵션 금지
--dry-run: credential 접근·HTTP 요청·파일 변경 없이 요청 계획만 출력
성공은 관찰 시점의 유효성으로 저장 성공·ID 예약·충돌 방지를 보장하지 않습니다. 자동 저장·자동 재시도하지 않습니다.

Example

stly apis validate --operation create --input input.json

stly apis validate 00000000-0000-0000-0000-000000000001 --operation update --input input.json --if-match '"상세 GET의 ETag"'