공통 · 워크스페이스 상태 조회

워크스페이스 상태 조회

Accesskey와 Secretkey 인증이 정상인지 확인하고 워크스페이스 이름과 구분(개인·사업자) 정보를 반환하는 API입니다. 호출이 성공하면 사용 가능한 상태이며, 비활성 워크스페이스는 호출 자체가 차단됩니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

GET /common/v1/workspace/status

워크스페이스 상태 조회

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`name`	string	워크스페이스 표시명입니다. 개인은 이름, 사업자는 상호입니다.
`type`	string	워크스페이스 구분입니다. 개인 또는 사업자입니다.
`business` 4개 필드	object	사업자 정보입니다. 사업자 워크스페이스면 객체로 내려가고, 개인 워크스페이스면 null입니다.
`corp_type`	string	사업자 유형입니다. 개인사업자 또는 법인사업자입니다.
`corp_number`	string	사업자등록번호입니다.
`corp_name`	string	상호입니다.
`corp_owner`	string	대표자명입니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "name": "주식회사 예시",
  "type": "사업자",
  "business": {
    "corp_type": "법인사업자",
    "corp_number": "1234567890",
    "corp_name": "주식회사 예시",
    "corp_owner": "홍길동"
  }
}