콘텐츠로 이동

【모바일 신서틱 테스트】이용 약관 상태



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를 보관하여 읽기 단계를 확인하세요.

문서 평가

이 페이지가 도움이 되었나요?