Project API

Prev Next

기본 정보

API URL

https://sens.apigw.gov-ntruss.com/common/v2

SENS Project API Swagger 바로가기

API Header

항목 Mandatory 설명
Content-Type Mandatory 요청 Body Content Type을 application/json으로 지정 (POST)
x-ncp-apigw-timestamp Mandatory 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것이다.
API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-iam-access-key Mandatory 포탈 또는 Sub Account에서 발급받은 Access Key ID
x-ncp-apigw-signature-v2 Mandatory 위 예제의 Body를 Access Key Id와 맵핑되는 SecretKey로 암호화한 서명
HMAC 암호화 알고리즘은 HmacSHA256 사용

NAVER CLOUD PLATFORM 인증키 및 Signature 생성 가이드 바로가기

프로젝트

프로젝트 생성

프로젝트를 생성합니다.

요청 URL

POST https://sens.apigw.gov-ntruss.com/common/v2/projects

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

없음

Headers

API Header 바로가기

요청 Body

{
  "projectName": "string",
  "projectDesc": "string",
  "useKkoBizMsg": "boolean",
  "usePush": "boolean",
  "useSms": "boolean"
}
항목 Mandatory Type 설명 비고
projectName Mandatory String 프로젝트 이름 - 영문 소문자, 숫자, 붙임표 ( - ), 밑줄 문자 ( _ )만 입력 가능
- 최대 24자
projectDesc Optional String 프로젝트 설명 최대 128자
useKkoBizMsg Optional Boolean 비즈메시지 서비스 사용 여부 default: false
usePush Optional Boolean PUSH 서비스 사용 여부 default: false
useSms Optional Boolean SMS 서비스 사용 여부 default: false
  • useKkoBizMsg, usePush, useSms의 경우 명시하지 않으면 기본값으로 false가 사용됩니다.
  • 사용 여부가 false라도 각 서비스에 해당하는 메타정보가 생성되며 추후 사용 여부를 변경할 수 있습니다.
참고

2024년 10월 17일 PUSH 서비스가 종료됩니다. 이에 따라 5월 09일부터 PUSH 서비스 신규 이용이 제한됩니다.

응답 Body

{
  "projectId": "string",
  "projectName": "string",
  "projectDesc": "string",
  "usePush": "boolean",
  "useSms": "boolean",
  "useKkoBizMsg": "boolean",
  "pushService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime"
  },
  "smsService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime",
    "useBlockService": "boolean"
  },
  "kkoBizMsgService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime"
  },
  "createTime": "localDateTime",
  "updateTime": "localDateTime"
}
항목 Mandatory Type 설명 비고
projectName Mandatory String 프로젝트 이름
projectDesc Mandatory String 프로젝트 설명
useKkoBizMsg Mandatory Boolean 비즈메시지 서비스 사용 여부
usePush Mandatory Boolean PUSH 서비스 사용 여부
useSms Mandatory Boolean SMS 서비스 사용 여부
createTime Mandatory String 생성 시간
updateTime Optional String 생성 시간
*Service.serviceId Mandatory String 서비스 아이디 SMS, PUSH, KkoBizMsg 공통
*Service.serviceName Mandatory String 서비스 이름 SMS, PUSH, KkoBizMsg 공통
*Service.createTime Mandatory String 서비스 생성 시간 SMS, PUSH, KkoBizMsg 공통
*Service.updateTime Optional String 서비스 수정 시간 SMS, PUSH, KkoBizMsg 공통
smsService.useBlockService Mandatory Boolean 080 수신 거부 번호 서비스 사용 여부

응답 Status

HTTP Status Desc
200 OK (생성 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

프로젝트 수정

프로젝트를 수정합니다.

요청 URL

PUT https://sens.apigw.gov-ntruss.com/common/v2/projects/{projectId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
projectId Mandatory String 프로젝트 아이디 프로젝트 생성 시 발급받은 프로젝트 아이디

Parameters

없음

Headers

API Header 바로가기

요청 Body

{
  "projectDesc": "string",
  "useKkoBizMsg": "boolean",
  "usePush": "boolean",
  "useSms": "boolean"
}
항목 Mandatory Type 설명 비고
projectDesc Optional String 프로젝트 설명 최대 128자
useKkoBizMsg Optional Boolean 비즈메시지 서비스 사용 여부 default: false
usePush Optional Boolean PUSH 서비스 사용 여부 default: false
useSms Optional Boolean SMS 서비스 사용 여부 default: false
  • projectName의 경우 기존 이름과 다른 이름을 사용하셔도 수정되지 않습니다.
  • useKkoBizMsg, usePush, useSms의 경우 명시하지 않으시면 기본값으로 false로 변경됩니다.

응답 Body

{
  "projectId": "string",
  "projectName": "string",
  "projectDesc": "string",
  "usePush": "boolean",
  "useSms": "boolean",
  "useKkoBizMsg": "boolean",
  "pushService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime"
  },
  "smsService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime",
    "useBlockService": "boolean",
            "blockService": {
                "available": "boolean",
                "companyName": "string",
                "statusName": "string",
                "createTime": "localDateTime",
                "updateTime": "localDateTime"
            }
  },
  "kkoBizMsgService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime"
  },
  "createTime": "localDateTime",
  "updateTime": "localDateTime"
}
항목 Mandatory Type 설명 비고
projectName Mandatory String 프로젝트 이름
projectDesc Mandatory String 프로젝트 설명
useKkoBizMsg Mandatory Boolean 비즈메시지 서비스 사용 여부
usePush Mandatory Boolean PUSH 서비스 사용 여부
useSms Mandatory Boolean SMS 서비스 사용 여부
createTime Mandatory String 생성 시간
updateTime Mandatory String 수정 시간
*Service.serviceId Mandatory String 서비스 아이디 SMS, PUSH, KkoBizMsg 공통
*Service.serviceName Mandatory String 서비스 이름 SMS, PUSH, KkoBizMsg 공통
*Service.createTime Mandatory String 서비스 생성 시간 SMS, PUSH, KkoBizMsg 공통
*Service.updateTime Optional String 서비스 수정 시간 SMS, PUSH, KkoBizMsg 공통
smsService.useBlockService Mandatory Boolean 080 수신 거부 번호 서비스 사용 여부
smsService.blockService.available Optional Boolean 사용 사능 여부
smsService.blockService.companyName Optional String 회사 이름
smsService.blockService.statusName Optional String 서비스 상태
smsService.blockService.createTime Optional String 서비스 생성 시간
smsService.blockService.updateTime Optional String 서비스 수정 시간

응답 Status

HTTP Status Desc
200 OK (수정 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

프로젝트 다건 조회

다건의 프로젝트를 조회합니다.

요청 URL

GET https://sens.apigw.gov-ntruss.com/common/v2/projects

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

없음

Parameters

항목 Mandatory Type 설명 비고
projectName Optional String 프로젝트 이름 like 조회 결과를 반환
pageSize Optional Integer 페이지 사이즈 default: 100
1 ~ 100 사이의 숫자만 입력 가능
pageIndex Optional Integer 페이지 인덱스 default: 0

Headers

API Header 바로가기

요청 Body

없음

응답 Body

[
    {
        "projectId": "string",
        "projectName": "string",
        "projectDesc": "string",
        "usePush": "boolean",
        "useSms": "boolean",
        "useKkoBizMsg": "boolean",
        "pushService": {
            "serviceId": "string",
            "serviceName": "string",
            "createTime": "localDateTime",
            "updateTime": "localDateTime"
        },
        "smsService": {
            "serviceId": "string",
            "serviceName": "string",
            "createTime": "localDateTime",
            "updateTime": "localDateTime",
            "useBlockService": "boolean",
            "blockService": {
                "available": "boolean",
                "companyName": "string",
                "statusName": "string",
                "createTime": "localDateTime",
                "updateTime": "localDateTime"
            }
        },
        "kkoBizMsgService": {
            "serviceId": "string",
            "serviceName": "string",
            "createTime": "localDateTime",
            "updateTime": "localDateTime"
        },
        "createTime": "localDateTime",
        "updateTime": "localDateTime"
    }
]
항목 Mandatory Type 설명 비고
projectName Mandatory String 프로젝트 이름
projectDesc Mandatory String 프로젝트 설명
useKkoBizMsg Mandatory Boolean 비즈메시지 서비스 사용 여부
usePush Mandatory Boolean PUSH 서비스 사용 여부
useSms Mandatory Boolean SMS 서비스 사용 여부
createTime Mandatory String 생성 시간
updateTime Optional String 생성 시간
*Service.serviceId Mandatory String 서비스 아이디 SMS, PUSH, KkoBizMsg 공통
*Service.serviceName Mandatory String 서비스 이름 SMS, PUSH, KkoBizMsg 공통
*Service.createTime Mandatory String 서비스 생성 시간 SMS, PUSH, KkoBizMsg 공통
*Service.updateTime Optional String 서비스 수정 시간 SMS, PUSH, KkoBizMsg 공통
smsService.useBlockService Mandatory Boolean 080 수신 거부 번호 서비스 사용 여부
smsService.blockService.available Optional Boolean 사용 사능 여부
smsService.blockService.companyName Optional String 회사 이름
smsService.blockService.statusName Optional String 서비스 상태
smsService.blockService.createTime Optional String 서비스 생성 시간
smsService.blockService.updateTime Optional String 서비스 수정 시간

응답 Status

HTTP Status Desc
200 OK (조회 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

프로젝트 단건 조회

단건의 프로젝트를 조회합니다.

요청 URL

GET https://sens.apigw.gov-ntruss.com/common/v2/projects/{projectId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
projectId Mandatory String 프로젝트 아이디 프로젝트 생성 시 발급받은 프로젝트 아이디

Parameters

없음

Headers

API Header 바로가기

요청 Body

없음

응답 Body

{
  "projectId": "string",
  "projectName": "string",
  "projectDesc": "string",
  "usePush": "boolean",
  "useSms": "boolean",
  "useKkoBizMsg": "boolean",
  "pushService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime"
  },
  "smsService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime",
    "useBlockService": "boolean",
            "blockService": {
                "available": "boolean",
                "companyName": "string",
                "statusName": "string",
                "createTime": "localDateTime",
                "updateTime": "localDateTime"
            }
  },
  "kkoBizMsgService": {
    "serviceId": "string",
    "serviceName": "string",
    "createTime": "localDateTime",
    "updateTime": "localDateTime"
  },
  "createTime": "localDateTime",
  "updateTime": "localDateTime"
}
항목 Mandatory Type 설명 비고
projectName Mandatory String 프로젝트 이름
projectDesc Mandatory String 프로젝트 설명
useKkoBizMsg Mandatory Boolean 비즈메시지 서비스 사용 여부
usePush Mandatory Boolean PUSH 서비스 사용 여부
useSms Mandatory Boolean SMS 서비스 사용 여부
createTime Mandatory String 생성 시간
updateTime Optional String 생성 시간
*Service.serviceId Mandatory String 서비스 아이디 SMS, PUSH, KkoBizMsg 공통
*Service.serviceName Mandatory String 서비스 이름 SMS, PUSH, KkoBizMsg 공통
*Service.createTime Mandatory String 서비스 생성 시간 SMS, PUSH, KkoBizMsg 공통
*Service.updateTime Optional String 서비스 수정 시간 SMS, PUSH, KkoBizMsg 공통
smsService.useBlockService Mandatory Boolean 080 수신 거부 번호 서비스 사용 여부
smsService.blockService.available Optional Boolean 사용 사능 여부
smsService.blockService.companyName Optional String 회사 이름
smsService.blockService.statusName Optional String 서비스 상태
smsService.blockService.createTime Optional String 서비스 생성 시간
smsService.blockService.updateTime Optional String 서비스 수정 시간

응답 Status

HTTP Status Desc
200 OK (조회 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

프로젝트 삭제

프로젝트를 삭제합니다.

요청 URL

DELETE https://sens.apigw.gov-ntruss.com/common/v2/projects/{projectId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
projectId Mandatory String 프로젝트 아이디 프로젝트 생성 시 발급받은 프로젝트 아이디

Parameters

없음

Headers

API Header 바로가기

요청 Body

없음

응답 Body

없음

응답 Status

HTTP Status Desc
204 No Content (삭제 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error
429 Too Many Requests