Korean

Project API

인쇄
공유
PDF

Project API

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

기본 정보

API URL

https://sens.apigw.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.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.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.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.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.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}