【모바일 신서틱 테스트】이용 약관 상태¶
GET /api/v1/dialing_task/mobile/terms
개요¶
모바일 신서틱 테스트 이용 약관의 워크스페이스 확인 상태를 조회합니다.
호출 전 및 사용 단계¶
OpenAPI 자격으로 조회할 수 있습니다. accepted는 유효한 서버 측 확인 기록을 나타내며 플랫폼 스위치 상태가 아닙니다. canAccept는 API Key에 대해 항상 false입니다. 유효한 기록이 없으면 accepted=false/acceptance=null입니다. 이전의 공통 구성이나 중복/손상된 기록은 동의로 간주하지 않습니다.
이 요청은 약관에 동의하지 않고 작업을 생성하지 않으며 모바일 플랫폼을 초기화하지도 않습니다. 모바일 신서틱 테스트 스위치가 꺼져 있다고 해서 직접 차단되지는 않습니다. 제품에 로그인한 뒤 워크스페이스 Owner/관리자가 약관을 읽고 확인해야 하며, 그 후 accepted=true를 조회해야 합니다. API Key에 관리자 역할을 부여한 것을 로그인 사용자의 확인 행위로 간주할 수 없습니다.
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
파라미터 추가 설명¶
워크스페이스는 인증 컨텍스트에서 가져옵니다. accepted/canAccept/acceptance만 반환합니다. 확인되지 않은 경우 acceptance=null이며, 확인 기록에는 acceptedBy와 서버 측 Unix 초 단위 acceptedAt만 포함됩니다. API Key는 자신의 워크스페이스만 조회할 수 있고 확인할 수 없습니다. 약관 주소, 언어, 제품 버전 구성은 없습니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/dialing_task/mobile/terms' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200 JSON. 이 라우트는 declaration을 명시적으로 건너뛰며 content에 해당 필드가 없습니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.accepted | boolean | 현재 워크스페이스에 서버에서 검증된 유효한 확인이 존재하는지 여부입니다. |
| content.canAccept | boolean | 현재 자격으로 확인할 수 있는지 여부입니다. OpenAPI 자격은 항상 false이며, API Key 역할로 로그인 멤버 자격을 위조할 수 없습니다. |
| content.acceptance | object 또는 null | 확인 기록입니다. 미확인/중복/손상된 이력 기록인 경우 null입니다. |
| content.acceptance.acceptedBy | string | 실제로 확인한 로그인 멤버의 acnt_ UUID이며, 이 API Key가 아닙니다. |
| content.acceptance.acceptedAt | integer | 서버 측 확인 시각의 Unix 초입니다. |
{
"code": 200,
"content": {
"accepted": false,
"canAccept": false,
"acceptance": null
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 403 | ft.Forbidden | 현재 호출 자격으로는 약관을 조회할 수 없습니다(정상적인 OpenAPI 자격이면 충족됨). | 작업 권한이 없습니다. | 대상 워크스페이스의 유효한 OpenAPI Key를 사용하고, 다른 공유/비멤버 자격 증명을 사용하지 마세요. |
| 401 | ft.WKSPNotExistOrReleased | 현재 워크스페이스가 존재하지 않음/해제됨 | 워크스페이스가 존재하지 않음/또는 해제됨 | 유효한 워크스페이스인지 확인하세요. |
| 500 | ft.InternalServerError | 저장소 읽기, 이전 구성 또는 로컬 정적 매핑 형식 예외 | 내부 오류 | 특정 작업/템플릿 또는 필터로 범위를 좁히고, 계속 실패하면 traceId를 보관하여 읽기 단계를 확인하세요. |