API 삭제
DELETE /v1/apis/{api_id}?confirm=true · 권한 apis:write
API를 소프트 삭제합니다. confirm=true와 If-Match는 필수입니다. 이 API에 대한 애플리케이션 권한과 이를 가리키는 애플리케이션의 기본 API 설정이 같은 작업에서 제거되고, 식별자는 90일 동안 재사용할 수 없으며, 이 대상에 대해 발급된 새로고침 세션은 취소됩니다. 시스템 API는 삭제할 수 없습니다.
요청
| 매개변수 | 위치 | 설명 |
|---|---|---|
api_id |
path | API ID. |
confirm |
query | true여야 합니다. |
If-Match |
header | 마지막 읽기의 ETag(필수). |
응답
204 No Content, 본문 없음.
오류
| HTTP | code | 언제 |
|---|---|---|
| 404 | not_found |
이 환경에 그러한 API가 없습니다. |
| 409 | conflict |
API가 시스템 API입니다. |
| 412 | precondition_failed |
If-Match가 현재 버전과 일치하지 않습니다. |
| 422 | validation_failed |
confirm이 누락되었거나 true가 아닙니다(/confirm). |
| 428 | precondition_required |
If-Match가 누락되었습니다. |
예제
curl -X DELETE "https://api.eu.keenauth.com/v1/apis/api_01h455vb4pex5vsknk084sn02q?confirm=true" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "1"'