Overview

Berith BaaS API는 블록체인 환경에 대해 잘 모르는 개발자라도 베리드가 제공하는 API를 활용해 서비스를 개발하고 운영, 모니터링 할 수 있도록 통합 비즈니스 API를 제공합니다.

Blockchain기반 Berith BaaS 서비스

  • NFT

    대체 불가능한 토큰으로 블록체인 기술을 활용하여 자신의 작품을 디지털 자산으로 발행하고 평가 받을 수 있습니다.
  • 전자계약

    블록체인 인증으로 투명한 전자계약체결이 가능한 개방형 블록체인전자계약 플랫폼 입니다.
  • Enterprise

    블록체인 활용을 원하는 기업을 위한 맞춤형 솔루션으로 블록체인 설치부터 관리, 모니터링까지 한번에 제공합니다.
  • Wallet

    암호화폐 사용자에게 필요한 다양한 기능을 제공함으로써 사용자는 안정적이고 편리하게 서비스를 이용하실 수 있습니다.
  • Pay

    블록체인과 핀테크 기술을 결합한 온/오프라인 지불 결제 서비스 입니다.
  • Membership

    규모와 지역에 제약 없이 적용 가능하며 소상공인도 쉽게 적용, 사용 가능한 종합 마켓팅 플랫폼 입니다.
  • SSO

    블록체인 기반 통합 SSO플랫폼으로 단 한번의 로그인만으로 기업의 각종 시스템과 서비스에 접속이 가능합니다.
  • 전자투표

    블록체인 기술 기반으로 정확한 투표 기록을 작성하고 결정을 내릴 수 있는 방식을 제시하는 플랫폼 입니다.
  • 추첨

    블록체인을 이용한 이벤트 추첨 시스템으로 스마트 컨트랙트를 이용해 이벤트 생성과 추첨을 자동화하였습니다.
  • 이력추적

    블록체인 기반의 데이터 검증 및 추적시스템으로 기록된 데이터와 이벤트의 히스토리를 추적 관리하는 서비스 입니다.

계정, 체인, 전자서명 트랜잭션, 개인키 생성 외 블록체인 자체검사, 노드로그 조회 등 다양한 블록체인 라이브러리를 제공하여 블록체인을 쉽게 접근하여 개발할 수 있도록 합니다.

회원

CI 중복 체크

POST /api/member/join/duplecateCheckCi
  • CI를 전달하여 회원 등록 가능 여부를 조회한다.

HTTP request

POST /api/member/join/duplecateCheckCi HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 27
Host: {url}

{
	"SEF_CERT_CI" : "b"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
		2.elb.amazonaws.com/api/member/join/duplecateCheckCi' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"SEF_CERT_CI" : "b"
}'

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

SEF_CERT_CI

String

본인 인증 CI

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 113

{
	"resultCode" : "E2001",
	"resultMessage" : "이미 가입된 회원입니다.",
	"resultData" : false
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Boolean

처리 결과

회원 등록

POST /api/member/join/join
  • 회원 정보를 신규 등록 한다.

HTTP request

POST /api/member/join/join HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 1164
Host: {url}

{
	"WRLS_TEL_NO2" : "7747",
	"WRLS_TEL_NO3" : "8226",
	"NTRY_PATH" : null,
	"STPL_AGRM" : [ {
		"COOPCO_CD" : "7000",
		"STPL_TYP_CD" : "10",
		"AGRM_YN" : "Y",
		"AGRM_DT" : "20211015",
		"AGRM_HR" : "140838",
		"AGRM_END_DT" : null,
		"AGRM_END_HR" : null
	}, {
		"COOPCO_CD" : "7000",
		"STPL_TYP_CD" : "20",
		"AGRM_YN" : "Y",
		"AGRM_DT" : "20211015",
		"AGRM_HR" : "140838",
		"AGRM_END_DT" : null,
		"AGRM_END_HR" : null
	}, {
		"COOPCO_CD" : "7010",
		"STPL_TYP_CD" : "30",
		"AGRM_YN" : "Y",
		"AGRM_DT" : "20211015",
		"AGRM_HR" : "140838",
		"AGRM_END_DT" : null,
		"AGRM_END_HR" : null
	}, {
		"COOPCO_CD" : "7020",
		"STPL_TYP_CD" : "30",
		"AGRM_YN" : "N",
		"AGRM_DT" : null,
		"AGRM_HR" : null,
		"AGRM_END_DT" : "20211015",
		"AGRM_END_HR" : "140838"
	} ],
	"GNDR_DV_CD" : "M",
	"NTRY_COOPCO_CD" : null,
	"NTRY_CHNL_CD" : null,
	"SEF_CERT_CI" : "20211015140838",
	"EML_ADDR" : "aaa@aaa.com",
	"BTDY" : "20211015",
	"MMB_ID" : "20211015140838",
	"PWD" : "20211015140838",
	"MMB_NM" : "20211015140838",
	"WRLS_TEL_NO1" : "010"
}

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
2.elb.amazonaws.com/api/member/join/join' -i -X POST \
	-H 'Content-Type: application/json;charset=UTF-8' \
	-d '{
"WRLS_TEL_NO2" : "7747",
"WRLS_TEL_NO3" : "8226",
"NTRY_PATH" : null,
"STPL_AGRM" : [ {
	"COOPCO_CD" : "7000",
	"STPL_TYP_CD" : "10",
	"AGRM_YN" : "Y",
	"AGRM_DT" : "20211015",
	"AGRM_HR" : "140838",
	"AGRM_END_DT" : null,
	"AGRM_END_HR" : null
}, {
	"COOPCO_CD" : "7000",
	"STPL_TYP_CD" : "20",
	"AGRM_YN" : "Y",
	"AGRM_DT" : "20211015",
	"AGRM_HR" : "140838",
	"AGRM_END_DT" : null,
	"AGRM_END_HR" : null
}, {
	"COOPCO_CD" : "7010",
	"STPL_TYP_CD" : "30",
	"AGRM_YN" : "Y",
	"AGRM_DT" : "20211015",
	"AGRM_HR" : "140838",
	"AGRM_END_DT" : null,
	"AGRM_END_HR" : null
}, {
	"COOPCO_CD" : "7020",
	"STPL_TYP_CD" : "30",
	"AGRM_YN" : "N",
	"AGRM_DT" : null,
	"AGRM_HR" : null,
	"AGRM_END_DT" : "20211015",
	"AGRM_END_HR" : "140838"
} ],
"GNDR_DV_CD" : "M",
"NTRY_COOPCO_CD" : null,
"NTRY_CHNL_CD" : null,
"SEF_CERT_CI" : "20211015140838",
"EML_ADDR" : "aaa@aaa.com",
"BTDY" : "20211015",
"MMB_ID" : "20211015140838",
"PWD" : "20211015140838",
"MMB_NM" : "20211015140838",
"WRLS_TEL_NO1" : "010"
}'

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

MMB_NM

String

회원 명

MMB_ID

String

회원 ID

PWD

String

비밀번호

BTDY

String

생일

GNDR_DV_CD

String

성별 구분 코드(M/F)

SEF_CERT_CI

String

본인 인증 CI

NTRY_COOPCO_CD

String

true

가입 제휴사 코드

NTRY_CHNL_CD

String

true

가입 채널 코드

NTRY_PATH

String

true

가입 경로

WRLS_TEL_NO1

String

무선 전화 번호1

WRLS_TEL_NO2

String

무선 전화 번호2

WRLS_TEL_NO3

String

무선 전화 번호3

EML_ADDR

String

이메일 주소

STPL_AGRM

Array

약관 동의 정보

Request fields-stplagrm

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

STPL_TYP_CD

String

약관 유형 코드

AGRM_YN

String

동의 여부(Y/N)

AGRM_DT

String

true

동의 일자 - 동의 여부 Y

AGRM_HR

String

true

동의 시간 - 동의 여부 Y

AGRM_END_DT

String

true

동의 종료 일자 - 동의 여부 N

AGRM_END_HR

String

true

동의 종료 시간 - 동의 여부 N

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1551

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"WRLS_TEL_NO2" : "7747",
		"WRLS_TEL_NO3" : "8226",
		"NTRY_PATH" : null,
		"STPL_AGRM" : [ {
			"COOPCO_CD" : "7000",
			"STPL_TYP_CD" : "10",
			"AGRM_YN" : "Y",
			"AGRM_DT" : "20211015",
			"AGRM_HR" : "140838",
			"AGRM_END_DT" : null,
			"AGRM_END_HR" : null,
			"UNFY_MMB_NO" : 293
		}, {
			"COOPCO_CD" : "7000",
			"STPL_TYP_CD" : "20",
			"AGRM_YN" : "Y",
			"AGRM_DT" : "20211015",
			"AGRM_HR" : "140838",
			"AGRM_END_DT" : null,
			"AGRM_END_HR" : null,
			"UNFY_MMB_NO" : 293
		}, {
			"COOPCO_CD" : "7010",
			"STPL_TYP_CD" : "30",
			"AGRM_YN" : "Y",
			"AGRM_DT" : "20211015",
			"AGRM_HR" : "140838",
			"AGRM_END_DT" : null,
			"AGRM_END_HR" : null,
			"UNFY_MMB_NO" : 293
		}, {
			"COOPCO_CD" : "7020",
			"STPL_TYP_CD" : "30",
			"AGRM_YN" : "N",
			"AGRM_DT" : null,
			"AGRM_HR" : null,
			"AGRM_END_DT" : "20211015",
			"AGRM_END_HR" : "140838",
			"UNFY_MMB_NO" : 293
		} ],
		"GNDR_DV_CD" : "M",
		"UNFY_MMB_NO" : 293,
		"NTRY_COOPCO_CD" : null,
		"NTRY_CHNL_CD" : null,
		"SEF_CERT_CI" : "20211015140838",
		"EML_ADDR" : "aaa@aaa.com",
		"BTDY" : "20211015",
		"MMB_ID" : "20211015140838",
		"PWD" : "08DA1AE3D982A390AD987567DE6FB009BDCCF40A7D046BD7C3AE8BF47D967187",
		"MMB_NM" : "20211015140838",
		"WRLS_TEL_NO1" : "010"
	}
}

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

MMB_NM

String

회원 명

MMB_ID

String

회원 ID

PWD

String

비밀번호

BTDY

String

생일

GNDR_DV_CD

String

성별 구분 코드(M/F)

SEF_CERT_CI

String

본인 인증 CI

NTRY_COOPCO_CD

String

true

가입 제휴사 코드

NTRY_CHNL_CD

String

true

가입 채널 코드

NTRY_PATH

String

true

가입 경로

WRLS_TEL_NO1

String

무선 전화 번호1

WRLS_TEL_NO2

String

무선 전화 번호2

WRLS_TEL_NO3

String

무선 전화 번호3

EML_ADDR

String

이메일 주소

STPL_AGRM

Array

약관 동의 정보

Response fields-stplagrm

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

STPL_TYP_CD

String

약관 유형 코드

AGRM_YN

String

동의 여부(Y/N)

AGRM_DT

String

true

동의 일자 - 동의 여부 Y

AGRM_HR

String

true

동의 시간 - 동의 여부 Y

AGRM_END_DT

String

true

동의 종료 일자 - 동의 여부 N

AGRM_END_HR

String

true

동의 종료 시간 - 동의 여부 N

회원 정보 조회

POST /api/member/info/getMemberInfo
  • token을 전달하여 회원 정보를 조회한다.

HTTP request

POST /api/member/info/getMemberInfo HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A
Content-Length: 28
Host: {url}

{
	"UNFY_MMB_NO" : "34"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
2.elb.amazonaws.com/api/member/info/getMemberInfo' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A' \
-d '{
"UNFY_MMB_NO" : "34"
}'
							

Request fields

Name Description

Content-Type

application/json

x-auth-token

토큰

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 977

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"REG_DTM" : 1630309860000,
		"MMB_ST_CD" : "1",
		"WRLS_TEL_NO2" : "ZuPqTBcXUAhkqChEd1pbEg==",
		"WRLS_TEL_NO3" : "3eLUC2Yh6TInAyVHRohKJA==",
		"STPL_AGRM_DTM" : 1630309860000,
		"NTRY_PATH" : null,
		"GNDR_DV_CD" : "JKd0c0jKF3VkSWxKESdbBw==",
		"UNFY_MMB_NO" : 34,
		"NTRY_COOPCO_CD" : null,
		"NTRY_CHNL_CD" : null,
		"CRD_NO" : null,
		"SEF_CERT_CI" : "MFvwbvB96mxTX19lL/SgWw==",
		"AG_NTRY_YN" : null,
		"TMP_PWD_YN" : "N",
		"EML_ADDR" : "KGlENVoyFvxlXQbhq6aTV+C0EZsOOheQZmgkG9LjLwE=",
		"BTDY" : "1wq82DPQsljAQD93vyg9Wg==",
		"CRD_REG_DTM" : 1630309860000,
		"UPD_DTM" : 1633412597000,
		"MMB_ID" : "lCfCRkAk5u3t9IDJxDQGug==",
		"PWD" : "7B521E15DD384168A914867DED0C24D62189CE32B31C79B0D0B60D0E95169ADF",
		"MMB_NM" : "MFvwbvB96mxTX19lL/SgWw==",
		"WRLS_TEL_NO1" : "k4xtAN3OMS7fL/5BBKkWvA=="
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

MMB_NM

String

회원 명

MMB_ID

String

회원 ID

TMP_PWD_YN

String

임시 비밀번호 여부

PWD

String

비밀번호

BTDY

String

생일

GNDR_DV_CD

String

성별 구분 코드

SEF_CERT_CI

String

본인 인증 CI

AG_NTRY_YN

String

true

재 가입 여부

NTRY_COOPCO_CD

String

true

가입 제휴사 코드

NTRY_CHNL_CD

String

true

가입 채널 코드

NTRY_PATH

String

true

가입 경로

MMB_ST_CD

String

회원 상태 코드

WRLS_TEL_NO1

String

무선 전화 번호1

WRLS_TEL_NO2

String

무선 전화 번호2

WRLS_TEL_NO3

String

무선 전화 번호3

EML_ADDR

String

이메일 주소

CRD_NO

String

true

카드 번호

CRD_REG_DTM

Number

카드 등록 일시

REG_DTM

Number

등록 일시

UPD_DTM

Number

변경 일시

STPL_AGRM_DTM

Number

약관 동의 일시

회원 약관 동의 여부 조회

POST /api/member/info/getMemberAgreeList
  • 특정 회원의 제휴사별 약관 동의 여부 및 동의/철회 일시를 조회한다.

HTTP request

POST /api/member/info/getMemberAgreeList HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A
Content-Length: 29
Host: {url}

{
	"UNFY_MMB_NO" : "113"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
		2.elb.amazonaws.com/api/member/info/getMemberAgreeList' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOH0.RBO0lRaVeGjjLDNQZs3Ua6Z7GhltiX5wQCc_xqdoC3A' \
		-d '{
	"UNFY_MMB_NO" : "113"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 799

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : [ {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : "20210917091341",
		"AGRM_YN" : "Y",
		"STPL_TYP_CD" : "10",
		"COOPCO_CD" : "7000",
		"AGRM_END_DTM" : null
	}, {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : "20210917091341",
		"AGRM_YN" : "Y",
		"STPL_TYP_CD" : "20",
		"COOPCO_CD" : "7000",
		"AGRM_END_DTM" : null
	}, {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : "20210917091341",
		"AGRM_YN" : "Y",
		"STPL_TYP_CD" : "30",
		"COOPCO_CD" : "7000",
		"AGRM_END_DTM" : null
	}, {
		"UNFY_MMB_NO" : 113,
		"AGRM_DTM" : null,
		"AGRM_YN" : "N",
		"STPL_TYP_CD" : "30",
		"COOPCO_CD" : "7020",
		"AGRM_END_DTM" : "20210917091341"
	} ]
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData[]

Array

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

COOPCO_CD

String

제휴사 코드

STPL_TYP_CD

String

약관 유형 코드

AGRM_YN

String

동의 여부(Y/N)

AGRM_DTM

String

true

동의 일시

AGRM_END_DTM

String

true

철회 일시

로그인

제휴사로그인, 일반로그인 관련 API를 제공합니다.

제휴사 로그인

POST /api/login/coopcoLogin
  • 제휴사 코드/비밀번호를 입력 후 로그인 한다.
  • 응답 받은 토큰을 사용하여 다른 API를 호출한다.

제휴사 로그인 성공

HTTP request

POST /api/login/coopcoLogin HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 47
Host: {url}

{
	"COOPCO_CD" : "7000",
	"PWD" : "sang"
}
							

Curl request

curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
2.elb.amazonaws.com/api/login/coopcoLogin' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"COOPCO_CD" : "7000",
	"PWD" : "sang"
}'
							

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

PWD

String

제휴사 로그인 비밀번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 239

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxN30.GCZq_2p5pXtojrrPjWnZUIyeigAmOiwVp3KCsR1NtL8"
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

String

토큰

제휴사 로그인 실패

HTTP request

POST /api/login/coopcoLogin HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 55
Host: {url}

{
	"COOPCO_CD" : "7000",
	"PWD" : "asdflj;lasdf"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
2.elb.amazonaws.com/api/login/coopcoLogin' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "COOPCO_CD" : "7000",
  "PWD" : "asdflj;lasdf"
}'
							

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

PWD

String

제휴사 로그인 비밀번호

HTTP response

HTTP/1.1 200 OK
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 78

{
	"resultCode" : "E0003",
	"resultMessage" : "제휴사 인증 실패"
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

로그인 성공

HTTP request

POST /api/login/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 50
Host: {url}

{
	"MMB_ID" : "sangkimyul",
	"PWD" : "sang"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
		2.elb.amazonaws.com/api/login/login' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"MMB_ID" : "sangkimyul",
	"PWD" : "sang"
}'
							

Request fields

Path Type Optional Description

MMB_ID

String

회원 ID

PWD

String

비밀번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 793

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"REG_DTM" : 1630309860000,
		"MMB_ST_CD" : "1",
		"WRLS_TEL_NO2" : "7747",
		"WRLS_TEL_NO3" : "8226",
		"STPL_AGRM_DTM" : 1630309860000,
		"NTRY_PATH" : null,
		"GNDR_DV_CD" : "M",
		"UNFY_MMB_NO" : 34,
		"NTRY_COOPCO_CD" : null,
		"NTRY_CHNL_CD" : null,
		"CRD_NO" : null,
		"SEF_CERT_CI" : "b",
		"AG_NTRY_YN" : null,
		"TMP_PWD_YN" : "N",
		"EML_ADDR" : "sangkimyul@naver.com",
		"BTDY" : "19870117",
		"CRD_REG_DTM" : 1630309860000,
		"UPD_DTM" : 1633412597000,
		"MMB_ID" : "sangkimyul",
		"PWD" : "7B521E15DD384168A914867DED0C24D62189CE32B31C79B0D0B60D0E95169ADF",
		"MMB_NM" : "b",
		"WRLS_TEL_NO1" : "010"
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

MMB_NM

String

회원 명

MMB_ID

String

회원 ID

TMP_PWD_YN

String

임시 비밀번호 여부

PWD

String

비밀번호

BTDY

String

생일

GNDR_DV_CD

String

성별 구분 코드

SEF_CERT_CI

String

본인 인증 CI

AG_NTRY_YN

String

true

재 가입 여부

NTRY_COOPCO_CD

String

true

가입 제휴사 코드

NTRY_CHNL_CD

String

true

가입 채널 코드

NTRY_PATH

String

true

가입 경로

MMB_ST_CD

String

회원 상태 코드

WRLS_TEL_NO1

String

무선 전화 번호1

WRLS_TEL_NO2

String

무선 전화 번호2

WRLS_TEL_NO3

String

무선 전화 번호3

EML_ADDR

String

이메일 주소

CRD_NO

String

true

카드 번호

CRD_REG_DTM

Number

카드 등록 일시

REG_DTM

Number

등록 일시

UPD_DTM

Number

변경 일시

STPL_AGRM_DTM

Number

약관 동의 일시

로그인 실패

HTTP request

								POST /api/login/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 58
Host: {url}

{
	"MMB_ID" : "sangkimyul",
	"PWD" : "asdflj;lasdf"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
		2.elb.amazonaws.com/api/login/login' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-d '{
	"MMB_ID" : "sangkimyul",
	"PWD" : "asdflj;lasdf"
}'
							

Request fields

Path Type Optional Description

MMB_ID

String

로그인 ID

PWD

String

로그인 비밀번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 78

{
	"resultCode" : "E0002",
	"resultMessage" : "사용자 인증 실패"
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

SSO로그인

SSO Server API는 SSO Agent의 Method를 호출하는 방식과 SSO VIEW URL을 호출(Web Browser에서 접근)하는 방식으로 구분된다

SSO 세션 생성 요청(WEB, APP)

POST /web(or app)/v1/createSSOSession
  • [WEB, APP] 최초 로그인을 위한 SSO세션 생성을 요청하고 유효한 회원의 경우, SSO 쿠키 발급을 위한 인증 토큰을 발급한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC, APP)

unityMberNo

Number

통합 회원 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

ssoAuthToken

String

sso 토큰

SSO 로그인을 위한 인증 토큰 요청(WEB)

POST /web/v1/getSSOAuthTokenForSSOLogin
  • [WEB] SSO 서버 상태를 확인하고, SSO 로그인을 위한 인증 토큰을 발급한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC)

HTTP response

내용없음
							

Response fields

Path Type Optional Description

ssoAuthToken

String

sso 토큰

SSO 로그아웃을 위한 인증 토큰 요청(WEB)

POST /web/v1/getSSOAuthTokenForSSOLogout
  • [WEB] SSO 서버 상태를 확인하고, SSO 로그아웃을 위한 인증 토큰을 발급한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC)

HTTP response

내용없음
							

Response fields

Path Type Optional Description

ssoAuthToken

String

sso 토큰

회원정보 요청(WEB, APP)

POST /web/v1/getMemberInfo
  • [WEB, APP]SSO 로그인( SSO 쿠키정보가 남아있는 경우) 시에 findSSOCookie 에서 전달받은 일회용 인증 키를 이용하여 SSO 서버에게 회원정보를 요청한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC, APP)

ssoAuthToken

String

sso 토큰

HTTP response

내용없음
							

Response fields

Path Type Optional Description

unityMberNo

Number

통합 회원 번호

SSO 세션 생성 요청(APP) [서버 SFA방식]

POST /web/v1/createSSOSessionAndVerifyToken
  • [APP] 최초 로그인을 위한 SSO세션 생성을 요청하고 유효한 회원의 경우, SSO 쿠키 발급을 위한 인증 토큰을 발급한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(APP)

unityMberNo

Number

통합 회원 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

ssoAuthToken

String

sso 토큰

회원정보 요청(APP) [서버 SFA방식]

POST /web/v1/getMemberInfoByVerifiedToken
  • [APP] SSO 로그인( SSO 쿠키정보가 남아있는 경우) 시에 findSSOCookie 에서 전달받은 일회용 인증 키를 이용하여 SSO 서버에게 회원정보를 요청한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(APP)

ssoAuthToken

String

sso 토큰

HTTP response

내용없음
							

Response fields

Path Type Optional Description

unityMberNo

Number

통합 회원 번호

회원정보 삭제(APP) [서버 SFA방식]

POST /web/v1/removeSSOSession
  • [APP] SSO 세션(토큰)을 삭제한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC, APP)

ssoAuthToken

String

sso 토큰

unityMberNo

Number

통합 회원 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

resultCode

String

결과 코드

최초 로그인(WEB)

POST /web/v1/createSSOCookie
  • [WEB] SSO 쿠키를 생성한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC)

ssoAuthToken

String

sso 토큰

returnUrl

String

로그인 이후 화면 url

SSO 로그인(WEB)

POST /web/v1/findSSOCookie
  • [WEB]사용자 브라우저에 SSO 쿠키가 있는지 확인 후 쿠키가 있으면 회원 정보 조회가 가능한 일회용 인증 키를 발급한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC)

ssoAuthToken

String

sso 토큰

returnUrl

String

로그인 이후 화면 url

SSO 로그아웃(WEB)

POST /web/v1/removeSSOCookie
  • [WEB] 사용자 브라우저에 SSO 쿠키가 있는지 확인하고 해당 세션 및 쿠키를 삭제한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request fields

Path Type Optional Description

chnnlCode

String

채널 코드(PC, APP)

ssoAuthToken

String

sso 토큰

returnUrl

String

로그아웃 이후 화면 url

멤버십

멤버십 포인트 적립, 사용 관련 API를 제공합니다.

포인트 적립 - 회원

POST /api/point/saveMemberPoint
  • 특정 회원의 포인트를 적립한다.

HTTP request

POST /api/point/saveMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 657
Host: {url}

{
	"ACML_TGT_AMT" : "50",
	"TRC_NO" : "20211015140840",
	"TOT_DC_AMT" : "",
	"PINT_ACML_TYP_CD" : "10",
	"TRSC_TYP_CD" : "200",
	"VALD_TRM" : "1",
	"TRSC_RSN_CD" : "RR01",
	"TRSC_DT" : "20211015",
	"BRND_CD" : "2000",
	"MBRSH_DC_AMT" : "",
	"MBRSH_PINT_SETL_YN" : "N",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"STOR_NO" : "2000",
	"ACML_PINT" : "123",
	"TOT_SEL_AMT" : "5000",
	"COOPCO_CD" : "7000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "21",
	"TRSC_HR" : "140840",
	"RMK" : "",
	"MMB_CERT_DV_CD" : "2",
	"AFT_ACML_YN" : "N",
	"UNIQ_RCGN_NO" : "20211015140840",
	"VALD_TRM_DV_CD" : "1"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
		2.elb.amazonaws.com/api/point/saveMemberPoint' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
		-d '{
	"ACML_TGT_AMT" : "50",
	"TRC_NO" : "20211015140840",
	"TOT_DC_AMT" : "",
	"PINT_ACML_TYP_CD" : "10",
	"TRSC_TYP_CD" : "200",
	"VALD_TRM" : "1",
	"TRSC_RSN_CD" : "RR01",
	"TRSC_DT" : "20211015",
	"BRND_CD" : "2000",
	"MBRSH_DC_AMT" : "",
	"MBRSH_PINT_SETL_YN" : "N",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"STOR_NO" : "2000",
	"ACML_PINT" : "123",
	"TOT_SEL_AMT" : "5000",
	"COOPCO_CD" : "7000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "21",
	"TRSC_HR" : "140840",
	"RMK" : "",
	"MMB_CERT_DV_CD" : "2",
	"AFT_ACML_YN" : "N",
	"UNIQ_RCGN_NO" : "20211015140840",
	"VALD_TRM_DV_CD" : "1"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

TRSC_ORGN_DV_CD

String

거래 발생 구분 코드

MMB_CERT_DV_CD

String

회원 인증 구분 코드

MMB_CERT_DV_VLU

String

회원 인증 구분값

TOT_SEL_AMT

String

총 매출 금액

TOT_DC_AMT

String

총 할인 금액

MBRSH_DC_AMT

String

멤버십 할인 금액

ACML_TGT_AMT

String

포인트 적립 대상 금액

TRSC_RSN_CD

String

거래 사유 코드

AFT_ACML_YN

String

사후 적립 여부

MBRSH_PINT_SETL_YN

String

멤버십 포인트 결제 여부

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

PINT_ACML_TYP_CD

String

포인트 적립 유형 코드

ACML_PINT

String

적립 포인트

VALD_TRM_DV_CD

String

유효 기간 구분

VALD_TRM

String

유효 개월수/기간

RMK

String

비고

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 529

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "210",
		"TRSC_BIZ_DV_CD" : "21",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140840",
		"TRC_NO" : "20211015140840",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000412",
		"ACML_PINT" : "123",
		"USE_PINT" : "0",
		"RMND_PINT" : 23625,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

ACML_PINT

String

적립 포인트

USE_PINT

String

사용 포인트

RMND_PINT

Number

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

포인트 적립 취소 - 회원

POST /api/point/saveMemberPointCancel
  • 특정 회원의 적립된 포인트를 취소한다.

HTTP request

POST /api/point/saveMemberPointCancel HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 520
Host: {url}

{
	"STOR_NO" : "2000",
	"TRC_NO" : "20211015140842",
	"PINT_ACML_TYP_CD" : "10",
	"TRSC_TYP_CD" : "200",
	"ORG_UNIQ_RCGN_NO" : "20211015140840",
	"TRSC_RSN_CD" : "RR01",
	"ORG_APV_NO" : "9000000412",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "2000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "22",
	"ORG_APV_DT" : "20211015",
	"TRSC_HR" : "140842",
	"MMB_CERT_DV_CD" : "2",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"UNIQ_RCGN_NO" : "20211015140842"
}
							

Curl request

$ curl 'http://{url}/api/point/saveMemberPointCancel' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
    -d '{
  "STOR_NO" : "2000",
  "TRC_NO" : "20211015140842",
  "PINT_ACML_TYP_CD" : "10",
  "TRSC_TYP_CD" : "200",
  "ORG_UNIQ_RCGN_NO" : "20211015140840",
  "TRSC_RSN_CD" : "RR01",
  "ORG_APV_NO" : "9000000412",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "2000",
  "MMB_CERT_DV_VLU" : "34",
  "TRSC_BIZ_DV_CD" : "22",
  "ORG_APV_DT" : "20211015",
  "TRSC_HR" : "140842",
  "MMB_CERT_DV_CD" : "2",
  "CHNL_TYP_CD" : "1",
  "TRSC_ORGN_DV_CD" : "10",
  "UNIQ_RCGN_NO" : "20211015140842"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

TRSC_ORGN_DV_CD

String

거래 발생 구분 코드

MMB_CERT_DV_CD

String

회원 인증 구분 코드

MMB_CERT_DV_VLU

String

회원 인증 구분값

TRSC_RSN_CD

String

거래 사유 코드

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

ORG_APV_DT

String

원 통합 승인 일자

ORG_APV_NO

String

원 통합 승인 번호

ORG_UNIQ_RCGN_NO

String

원 제휴사 고유 식별 번호

PINT_ACML_TYP_CD

String

포인트 적립 유형 코드

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 529

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "210",
		"TRSC_BIZ_DV_CD" : "22",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140842",
		"TRC_NO" : "20211015140842",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000413",
		"ACML_PINT" : "123",
		"USE_PINT" : "0",
		"RMND_PINT" : 23502,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

ACML_PINT

String

적립 포인트

USE_PINT

String

사용 포인트

RMND_PINT

Number

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

포인트 사용 - 회원

POST /api/point/useMemberPoint
  • 특정 회원의 포인트를 사용 한다.

HTTP request

POST /api/point/useMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs
Content-Length: 533
Host: {url}

{
	"STOR_NO" : "2000",
	"TRC_NO" : "20211015140842",
	"TOT_DC_AMT" : "1000",
	"TRSC_TYP_CD" : "300",
	"TRSC_RSN_CD" : "CD01",
	"TOT_SEL_AMT" : "5000",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "2000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "31",
	"MBRSH_DC_AMT" : "10",
	"USE_PINT" : "1000",
	"TRSC_HR" : "140842",
	"RMK" : "",
	"MMB_CERT_DV_CD" : "2",
	"PINT_USE_TYP_CD" : "11",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"UNIQ_RCGN_NO" : "20211015140842"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
	2.elb.amazonaws.com/api/point/useMemberPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs' \
    -d '{
  "STOR_NO" : "2000",
  "TRC_NO" : "20211015140842",
  "TOT_DC_AMT" : "1000",
  "TRSC_TYP_CD" : "300",
  "TRSC_RSN_CD" : "CD01",
  "TOT_SEL_AMT" : "5000",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "2000",
  "MMB_CERT_DV_VLU" : "34",
  "TRSC_BIZ_DV_CD" : "31",
  "MBRSH_DC_AMT" : "10",
  "USE_PINT" : "1000",
  "TRSC_HR" : "140842",
  "RMK" : "",
  "MMB_CERT_DV_CD" : "2",
  "PINT_USE_TYP_CD" : "11",
  "CHNL_TYP_CD" : "1",
  "TRSC_ORGN_DV_CD" : "10",
  "UNIQ_RCGN_NO" : "20211015140842"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

TRSC_ORGN_DV_CD

String

거래 발생 구분 코드

MMB_CERT_DV_CD

String

회원 인증 구분 코드

MMB_CERT_DV_VLU

String

회원 인증 구분값

TOT_SEL_AMT

String

총 매출 금액

TOT_DC_AMT

String

총 할인 금액

MBRSH_DC_AMT

String

멤버십 할인 금액

TRSC_RSN_CD

String

거래 사유 코드

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

PINT_USE_TYP_CD

String

포인트 사용 유형 코드

USE_PINT

String

사용 포인트

RMK

String

비고

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 528

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "310",
		"TRSC_BIZ_DV_CD" : "31",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140842",
		"TRC_NO" : "20211015140842",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000414",
		"ACML_PINT" : 0,
		"USE_PINT" : "1000",
		"RMND_PINT" : 22502,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

ACML_PINT

Number

적립 포인트

USE_PINT

String

사용 포인트

RMND_PINT

Number

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

포인트 사용 취소 - 회원

POST /api/point/useMemberPointCancel
  • 특정 회원의 사용된 포인트를 취소한다.

HTTP request

POST /api/point/useMemberPointCancel HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs
Content-Length: 519
Host: {url}

{
	"STOR_NO" : "2000",
	"TRC_NO" : "20211015140844",
	"TRSC_TYP_CD" : "300",
	"ORG_UNIQ_RCGN_NO" : "20211015140842",
	"TRSC_RSN_CD" : "CD01",
	"ORG_APV_NO" : "9000000414",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "2000",
	"MMB_CERT_DV_VLU" : "34",
	"TRSC_BIZ_DV_CD" : "32",
	"ORG_APV_DT" : "20211015",
	"TRSC_HR" : "140844",
	"MMB_CERT_DV_CD" : "2",
	"PINT_USE_TYP_CD" : "11",
	"CHNL_TYP_CD" : "1",
	"TRSC_ORGN_DV_CD" : "10",
	"UNIQ_RCGN_NO" : "20211015140844"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-
	2.elb.amazonaws.com/api/point/useMemberPointCancel' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMn0.KXRvkZcmJtrUqYfWl1veWqMbUHzYENG6QbDlHInffUs' \
    -d '{
  "STOR_NO" : "2000",
  "TRC_NO" : "20211015140844",
  "TRSC_TYP_CD" : "300",
  "ORG_UNIQ_RCGN_NO" : "20211015140842",
  "TRSC_RSN_CD" : "CD01",
  "ORG_APV_NO" : "9000000414",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "2000",
  "MMB_CERT_DV_VLU" : "34",
  "TRSC_BIZ_DV_CD" : "32",
  "ORG_APV_DT" : "20211015",
  "TRSC_HR" : "140844",
  "MMB_CERT_DV_CD" : "2",
  "PINT_USE_TYP_CD" : "11",
  "CHNL_TYP_CD" : "1",
  "TRSC_ORGN_DV_CD" : "10",
  "UNIQ_RCGN_NO" : "20211015140844"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

TRSC_ORGN_DV_CD

String

거래 발생 구분 코드

MMB_CERT_DV_CD

String

회원 인증 구분 코드

MMB_CERT_DV_VLU

String

회원 인증 구분값

TRSC_RSN_CD

String

거래 사유 코드

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

ORG_APV_DT

String

원 통합 승인 일자

ORG_APV_NO

String

원 통합 승인 번호

ORG_UNIQ_RCGN_NO

String

원 제휴사 고유 식별 번호

PINT_USE_TYP_CD

String

포인트 사용 유형 코드

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 528

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "310",
		"TRSC_BIZ_DV_CD" : "32",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140844",
		"TRC_NO" : "20211015140844",
		"CHNL_TYP_CD" : "1",
		"APV_DT" : "20211015",
		"APV_NO" : "9000000415",
		"ACML_PINT" : 0,
		"USE_PINT" : "1000",
		"RMND_PINT" : 23502,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

TRSC_TYP_CD

String

거래 유형 코드

TRSC_BIZ_DV_CD

String

업무 구분 코드

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

ACML_PINT

Number

적립 포인트

USE_PINT

String

사용 포인트

RMND_PINT

Number

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

포인트 조회 - 회원

POST /api/point/getMemberPoint
  • 특정 회원의 포인트 정보를 조회한다.

HTTP request

								POST /api/point/getMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA
Content-Length: 53
Host: {url}

{
  "UNFY_MMB_NO" : "34",
  "COOPCO_CD" : "7000"
}
							

Curl request

$ curl 'http://{url}/api/point/getMemberPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA' \
    -d '{
  "UNFY_MMB_NO" : "34",
  "COOPCO_CD" : "7000"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

UNFY_MMB_NO

String

통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 311

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"UNFY_MMB_NO" : 34,
		"XTNCT_SCHE_PINT" : 25356,
		"USE_PINT_CMLT" : 7060,
		"TNSF_POSB_PINT" : 11502,
		"RMND_PINT" : 23502,
		"ACML_PINT_CMLT" : 30562,
		"STPL_AGRM_YN" : "Y"
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

STPL_AGRM_YN

String

제휴사 정보제공 동의 여부

RMND_PINT

Number

잔여 포인트

TNSF_POSB_PINT

Number

선물 가능 포인트

ACML_PINT_CMLT

Number

총 적립 누적 포인트

USE_PINT_CMLT

Number

총 사용 누적 포인트

XTNCT_SCHE_PINT

Number

당월 소멸 예정 포인트

총 적립 포인트(누적) 조회 - 회원

POST /api/point/getMemberTotalSavedPoint
  • 특정 회원의 누적된 적립 포인트를 조회한다.

HTTP request

POST /api/point/getMemberTotalSavedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 28
Host: {url}

{
	"UNFY_MMB_NO" : "34"
}
							

Curl request

$ curl 'http://{url}/api/point/getMemberTotalSavedPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
    -d '{
  "UNFY_MMB_NO" : "34"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 166

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"UNFY_MMB_NO" : 34,
		"ACML_PINT_CMLT" : 30562
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

ACML_PINT_CMLT

Number

총 적립 누적 포인트

총 사용 포인트(누적) 조회 - 회원

POST /api/point/getMemberTotalUsedPoint
  • 특정 회원의 누적된 사용 포인트를 조회한다.

HTTP request

POST /api/point/getMemberTotalUsedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc
Content-Length: 28
Host: {url}

{
	"UNFY_MMB_NO" : "34"
}
							

Curl request

$ curl 'http://{url}/api/point/getMemberTotalUsedPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc' \
    -d '{
  "UNFY_MMB_NO" : "34"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 164

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"UNFY_MMB_NO" : 34,
		"USE_PINT_CMLT" : 7060
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

Number

통합 회원 번호

USE_PINT_CMLT

Number

총 사용 누적 포인트

포인트 거래 내역(소멸, 적립, 사용) 조회 - 회원

POST /api/point/listMemberPoint
  • 특정 회원의 포인트 거래(소멸, 적립, 사용) 목록을 조회한다.

HTTP request

POST /api/point/listMemberPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://{url}/api/point/listMemberPoint' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
    -d '{
  "STOR_NO" : "1000",
  "TRC_NO" : "20211015140839",
  "SRCH_DV_VLU" : "34",
  "SRCH_DV" : "2",
  "PAGE" : "1",
  "LIMIT" : "5",
  "TRSC_DT" : "20211015",
  "COOPCO_CD" : "7000",
  "BRND_CD" : "1000",
  "START_DT" : "20210915",
  "TRSC_HR" : "140839",
  "CHNL_TYP_CD" : "1",
  "END_DT" : "20211015"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

SRCH_DV

String

회원 인증 구분 코드

SRCH_DV_VLU

String

회원 인증 구분값

START_DT

String

조회 시작 일자

END_DT

String

조회 종료 일자

PAGE

String

페이지 번호

LIMIT

String

페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2378

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "10",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140839",
		"TRC_NO" : "20211015140839",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "140521",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000411",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140521",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000410",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000409",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140517",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000408",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140517",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140459",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000407",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140459",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 33,
		"TOTAL_CNT" : 161,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

TOTAL_PAGE

Number

전체 페이지 수

TOTAL_CNT

Number

전체 내역 수

RMND_PINT

String

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

RESULTS

Array

조회 결과

Response fields-resultdata-results

Path Type Optional Description

RNUM

Number

순번

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

PINT_CAN_POSB_YN

String

취소 가능 여부

TRSC_RSN_CD

String

거래 사유 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRSC_DV_CD

Number

거래 구분 코드

PINT

Number

포인트

STOR_NM

String

사용처

RMK

String

포인트 내용

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

포인트 거래 적립 내역 조회 - 회원

POST /api/point/listMemberSavedPoint

HTTP request

POST /api/point/listMemberSavedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-2
								.elb.amazonaws.com/api/point/listMemberSavedPoint' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
		-d '{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

SRCH_DV

String

회원 인증 구분 코드

SRCH_DV_VLU

String

회원 인증 구분값

START_DT

String

조회 시작 일자

END_DT

String

조회 종료 일자

PAGE

String

페이지 번호

LIMIT

String

페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2374

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "20",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140839",
		"TRC_NO" : "20211015140839",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000409",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140517",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000408",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140517",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140456",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000405",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140456",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140454",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000404",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015140454",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "135505",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000401",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "RR01",
			"UNIQ_RCGN_NO" : "20211015135505",
			"PINT" : 123,
			"TRSC_DT" : "20211015"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 17,
		"TOTAL_CNT" : 81,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

TOTAL_PAGE

Number

전체 페이지 수

TOTAL_CNT

Number

전체 내역 수

RMND_PINT

String

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

RESULTS

Array

조회 결과

Response fields-resultdata-results

Path Type Optional Description

RNUM

Number

순번

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

PINT_CAN_POSB_YN

String

취소 가능 여부

TRSC_RSN_CD

String

거래 사유 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRSC_DV_CD

Number

거래 구분 코드

PINT

Number

포인트

STOR_NM

String

사용처

RMK

String

포인트 내용

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

포인트 거래 사용 내역 조회 - 회원

POST /api/point/listMemberUsedPoint
  • 특정 회원의 포인트 사용 거래 목록을 조회한다.

HTTP request

POST /api/point/listMemberUsedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140845",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140845",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-2
		.elb.amazonaws.com/api/point/listMemberUsedPoint' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNX0.qqxXheeSKIxMlj5lW4a65tdtKNBEhzO-_SKdOgtzLhA' \
		-d '{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140845",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140845",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

SRCH_DV

String

회원 인증 구분 코드

SRCH_DV_VLU

String

회원 인증 구분값

START_DT

String

조회 시작 일자

END_DT

String

조회 종료 일자

PAGE

String

페이지 번호

LIMIT

String

페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2379

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "30",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140845",
		"TRC_NO" : "20211015140845",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "140844",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000415",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140844",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140842",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000414",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140842",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140521",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000411",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140521",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000410",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140519",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		}, {
			"TRSC_HR" : "140459",
			"RMK" : "제휴사 상품구매",
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"APV_NO" : "9000000407",
			"STOR_NM" : "7000",
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : "CD01",
			"UNIQ_RCGN_NO" : "20211015140459",
			"PINT" : 1000,
			"TRSC_DT" : "20211015"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 17,
		"TOTAL_CNT" : 81,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

Response fields-resultdata-results

Path Type Optional Description

RNUM

Number

순번

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

PINT_CAN_POSB_YN

String

취소 가능 여부

TRSC_RSN_CD

String

거래 사유 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRSC_DV_CD

Number

거래 구분 코드

PINT

Number

포인트

STOR_NM

String

사용처

RMK

String

포인트 내용

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

포인트 거래 소멸 내역 조회 - 회원

POST /api/point/listMemberDisappearedPoint
  • 특정 회원의 포인트 소멸 거래 목록을 조회한다.

HTTP request

POST /api/point/listMemberDisappearedPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140838",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140838",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://internal-NIPA-Project-APIServer-Internal-600774844.ap-northeast-2
	.elb.amazonaws.com/api/point/listMemberDisappearedPoint' -i -X POST \
	-H 'Content-Type: application/json;charset=UTF-8' \
	-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
	-d '{
"STOR_NO" : "1000",
"TRC_NO" : "20211015140838",
"SRCH_DV_VLU" : "34",
"SRCH_DV" : "2",
"PAGE" : "1",
"LIMIT" : "5",
"TRSC_DT" : "20211015",
"COOPCO_CD" : "7000",
"BRND_CD" : "1000",
"START_DT" : "20210915",
"TRSC_HR" : "140838",
"CHNL_TYP_CD" : "1",
"END_DT" : "20211015"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

SRCH_DV

String

회원 인증 구분 코드

SRCH_DV_VLU

String

회원 인증 구분값

START_DT

String

조회 시작 일자

END_DT

String

조회 종료 일자

PAGE

String

페이지 번호

LIMIT

String

페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 839

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "41",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140838",
		"TRC_NO" : "20211015140838",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"TRSC_HR" : "130313",
			"RMK" : null,
			"RNUM" : 1,
			"APV_DT" : null,
			"APV_NO" : null,
			"STOR_NM" : null,
			"TRSC_DV_CD" : 41,
			"PINT_CAN_POSB_YN" : "N",
			"TRSC_RSN_CD" : null,
			"UNIQ_RCGN_NO" : null,
			"PINT" : 1000,
			"TRSC_DT" : "20210923"
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 1,
		"TOTAL_CNT" : 1,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

TOTAL_PAGE

Number

전체 페이지 수

TOTAL_CNT

Number

전체 내역 수

RMND_PINT

String

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

RESULTS

Array

조회 결과

Response fields-resultdata-results

Path Type Optional Description

RNUM

Number

순번

APV_DT

Null

통합 승인 일자

APV_NO

Null

통합 승인 번호

PINT_CAN_POSB_YN

String

취소 가능 여부

TRSC_RSN_CD

Null

거래 사유 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRSC_DV_CD

Number

거래 구분 코드

PINT

Number

포인트

STOR_NM

Null

사용처

RMK

Null

포인트 내용

UNIQ_RCGN_NO

Null

제휴사 고유 식별 번호

포인트 거래 상세 내역(소멸, 적립, 사용) 조회 - 관리자

POST /api/point/listMemberPointDetail
  • 특정 회원의 포인트 상세 거래(소멸, 적립, 사용) 목록을 조회한다.

HTTP request

POST /api/point/listMemberPointDetail HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 316
Host: {url}

{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}
							

Curl request

$ curl 'http://{url}/api/point/listMemberPointDetail' -i -X POST \
		-H 'Content-Type: application/json;charset=UTF-8' \
		-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
		-d '{
	"STOR_NO" : "1000",
	"TRC_NO" : "20211015140839",
	"SRCH_DV_VLU" : "34",
	"SRCH_DV" : "2",
	"PAGE" : "1",
	"LIMIT" : "5",
	"TRSC_DT" : "20211015",
	"COOPCO_CD" : "7000",
	"BRND_CD" : "1000",
	"START_DT" : "20210915",
	"TRSC_HR" : "140839",
	"CHNL_TYP_CD" : "1",
	"END_DT" : "20211015"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

제휴사 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRC_NO

String

추적 번호

CHNL_TYP_CD

String

채널 유형 코드

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

SRCH_DV

String

회원 인증 구분 코드

SRCH_DV_VLU

String

회원 인증 구분값

START_DT

String

조회 시작 일자

END_DT

String

조회 종료 일자

PAGE

String

페이지 번호

LIMIT

String

페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3859

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"TRSC_TYP_CD" : "130",
		"TRSC_BIZ_DV_CD" : "10",
		"COOPCO_CD" : "7000",
		"TRSC_DT" : "20211015",
		"TRSC_HR" : "140839",
		"TRC_NO" : "20211015140839",
		"CHNL_TYP_CD" : "1",
		"RESULTS" : [ {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : 1000,
			"APV_NO" : "9000000411",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "CD01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : 10,
			"TRSC_HR" : "140521",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 1,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 22502,
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "Y",
			"UNIQ_RCGN_NO" : "20211015140521",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 1000
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : null,
			"APV_NO" : "9000000409",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "RR01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : null,
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 2,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 23625,
			"TRSC_DV_CD" : 22,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : null,
			"UNIQ_RCGN_NO" : "20211015140519",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 123
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : 1000,
			"APV_NO" : "9000000410",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "CD01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : 10,
			"TRSC_HR" : "140519",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 3,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 23502,
			"TRSC_DV_CD" : 31,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "Y",
			"UNIQ_RCGN_NO" : "20211015140519",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 1000
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : null,
			"APV_NO" : "9000000408",
			"STOR_NM" : "7000",
			"VALD_TRM" : 1,
			"TRSC_RSN_CD" : "RR01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : null,
			"TRSC_HR" : "140517",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 4,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 23502,
			"TRSC_DV_CD" : 21,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "N",
			"UNIQ_RCGN_NO" : "20211015140517",
			"VALD_TRM_DV_CD" : "1",
			"PINT" : 123
		}, {
			"STOR_NO" : "2000",
			"TOT_DC_AMT" : 1000,
			"APV_NO" : "9000000407",
			"STOR_NM" : "7000",
			"VALD_TRM" : null,
			"TRSC_RSN_CD" : "CD01",
			"TOT_SEL_AMT" : 5000,
			"TRSC_DT" : "20211015",
			"BRND_CD" : "2000",
			"MBRSH_DC_AMT" : 10,
			"TRSC_HR" : "140459",
			"RMK" : "제휴사 상품구매",
			"UNFY_MMB_NO" : 34,
			"RNUM" : 5,
			"APV_DT" : "20211015",
			"TRSC_BEF_RMND_PINT" : 22502,
			"TRSC_DV_CD" : 32,
			"PINT_CAN_POSB_YN" : "N",
			"MBRSH_PINT_SETL_YN" : "Y",
			"UNIQ_RCGN_NO" : "20211015140459",
			"VALD_TRM_DV_CD" : null,
			"PINT" : 1000
		} ],
		"UNFY_MMB_NO" : "34",
		"RMND_PINT" : "23502",
		"TOTAL_PAGE" : 33,
		"TOTAL_CNT" : 161,
		"RES_CD" : "00000",
		"RES_MSG" : "정상적으로 처리 되었습니다."
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

UNFY_MMB_NO

String

통합 회원 번호

TOTAL_PAGE

Number

전체 페이지 수

TOTAL_CNT

Number

전체 내역 수

RMND_PINT

String

잔여 포인트

RES_CD

String

응답 코드

RES_MSG

String

응답 메시지

RESULTS

Array

조회 결과

Response fields-resultdata-results

Path Type Optional Description

RNUM

Number

순번

APV_DT

String

통합 승인 일자

APV_NO

String

통합 승인 번호

PINT_CAN_POSB_YN

String

취소 가능 여부

TRSC_RSN_CD

String

거래 사유 코드

TRSC_DT

String

거래 일자

TRSC_HR

String

거래 시간

TRSC_DV_CD

Number

거래 구분 코드

PINT

Number

포인트

STOR_NM

String

사용처

RMK

String

포인트 내용

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

UNFY_MMB_NO

Number

통합 회원 번호

BRND_CD

String

브랜드 코드

STOR_NO

String

가맹점 코드

VALD_TRM_DV_CD

Null

유효 기간 구분

VALD_TRM

Null

유효 개월수/기간

TOT_SEL_AMT

Number

총 매출 금액

TOT_DC_AMT

Number

총 할인 금액

MBRSH_DC_AMT

Number

멤버십 할인 금액

MBRSH_PINT_SETL_YN

String

멤버십 포인트 결제 여부

TRSC_BEF_RMND_PINT

Number

거래 전 잔여 포인트

마이너스 포인트 내역 조회 - 관리자

POST /api/point/listMemberMinusPoint
  • 마이너스 포인트 상태의 회원 목록을 조회한다.

HTTP request

POST /api/point/listMemberMinusPoint HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o
Content-Length: 137
Host: {url}

{
	"UNFY_MMB_NO" : null,
	"MMB_ID" : null,
	"PAGE" : "1",
	"LIMIT" : "5",
	"END_DT" : "20210930",
	"START_DT" : "20210901"
}
							

Curl request

$ curl 'http://{url}/api/point/listMemberMinusPoint' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyMH0.ykCMm0gnL07LO-gB_-LXQ-f5geZdxEfcAm6J4TmZf6o' \
-d '{
"UNFY_MMB_NO" : null,
"MMB_ID" : null,
"PAGE" : "1",
"LIMIT" : "5",
"END_DT" : "20210930",
"START_DT" : "20210901"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

UNFY_MMB_NO

String

true

통합 회원 번호

MMB_ID

String

true

회원 ID

START_DT

String

조회 시작 일자

END_DT

String

조회 종료 일자

PAGE

String

페이지 번호

LIMIT

String

페이지 건수

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 697

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"RESULTS" : [ {
			"STOR_NO" : "1000",
			"APV_NO" : "9000000100",
			"MINUS_PINT" : 800,
			"STOR_NM" : "POINT",
			"COOPCO_CD" : "7000",
			"BRND_NM" : "POINT",
			"COOPCO_NM" : "BE MEMBERSHIP",
			"BRND_CD" : "1000",
			"MAPG_PINT" : 900,
			"UNFY_MMB_NO" : 90,
			"RNUM" : 1,
			"APV_DT" : "20210913",
			"MMB_ID" : "sangkimyul1",
			"UNIQ_RCGN_NO" : "700020210913130320",
			"CONTENT" : "POINT 제휴사 상품구매 적립취소",
			"MMB_NM" : "김상열"
		} ],
		"TOTAL_PAGE" : 1,
		"TOTAL_CNT" : 1
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Object

처리 결과

Response fields-resultdata

Path Type Optional Description

TOTAL_PAGE

Number

전체 페이지 수

TOTAL_CNT

Number

전체 내역 수

RESULTS

Array

조회 결과

Response fields-resultdata-results

Path Type Optional Description

RNUM

Number

순번

MMB_ID

String

고객ID

MMB_NM

String

고객명

UNFY_MMB_NO

Number

통합회원번호

COOPCO_CD

String

제휴사 코드

COOPCO_NM

String

제휴사 명

BRND_CD

String

브랜드 코드

BRND_NM

String

브랜드 명

STOR_NO

String

매장 코드

STOR_NM

String

매장 명

CONTENT

String

거래사유

MAPG_PINT

Number

매핑 포인트

MINUS_PINT

Number

마이너스 포인트

APV_DT

String

원 승인일자

APV_NO

String

원 승인번호

UNIQ_RCGN_NO

String

제휴사 고유 식별 번호

정산내역 조회 - 운영사

POST /api/point/listCoopcoTstPintMmSumr

HTTP request

POST /api/point/listCoopcoTstPintMmSumr HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc
Content-Length: 58
Host: {url}

{
	"COOPCO_CD" : "7000",
	"CLOSE_YEARMM" : "202109"
}
							

Curl request

$ curl 'http://{url}/api/point/listCoopcoTstPintMmSumr' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUyNH0.nfk5Z3mDTc8cLh3gN_AyYUd2Dq07A7WsFJBA0Me6-jc' \
    -d '{
  "COOPCO_CD" : "7000",
  "CLOSE_YEARMM" : "202109"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

운영사 코드

CLOSE_YEARMM

String

조회 년/월 'YYYYMM'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3838

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"RESULTS" : [ {
			"GUBUN_2" : "일반",
			"SUM_33" : 37539,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"SUM_13" : 30383,
			"SUM_28" : 37539,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : "적립 계",
			"SUM_33" : 37539,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"SUM_13" : 30383,
			"SUM_28" : 37539,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : null,
			"SUM_33" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "적립취소"
		}, {
			"GUBUN_2" : null,
			"SUM_33" : 37539,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"SUM_13" : 30383,
			"SUM_28" : 37539,
			"GUBUN_1" : "적립 계(적립취소 반영)"
		}, {
			"GUBUN_2" : "회원탈퇴소멸",
			"SUM_33" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "유효기간경과소멸",
			"SUM_33" : 1000,
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"SUM_13" : 1000,
			"SUM_28" : 1000,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "소멸 계",
			"SUM_33" : 1000,
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"SUM_13" : 1000,
			"SUM_28" : 1000,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : 2960,
			"GUBUN_3" : "POINT",
			"SUM_12" : 945,
			"GUBUN_4" : null,
			"SUM_13" : 2015,
			"SUM_28" : 2960,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : 6000,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : 3000,
			"GUBUN_4" : null,
			"SUM_13" : 3000,
			"SUM_28" : 6000,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : 8960,
			"GUBUN_3" : "사용 계",
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"SUM_13" : 5015,
			"SUM_28" : 8960,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "사용 계",
			"SUM_33" : 8960,
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"SUM_13" : 5015,
			"SUM_28" : 8960,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : null,
			"GUBUN_3" : "POINT",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : null,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "BE MEMBERSHIP",
			"SUM_33" : null,
			"GUBUN_3" : "사용취소 계",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "사용취소 계",
			"SUM_33" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"SUM_13" : null,
			"SUM_28" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"SUM_33" : 8960,
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"SUM_13" : 5015,
			"SUM_28" : 8960,
			"GUBUN_1" : "사용 계(사용취소(전월)반영)"
		} ]
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Array

처리 결과

Response fields-resultdata-results

Path Type Optional Description

GUBUN_1

String

1DEPTH

GUBUN_2

String

2DEPTH

GUBUN_3

Null

3DEPTH

GUBUN_4

Null

4DEPTH

SUM_12

Number

제휴사1 내역

SUM_13

Number

제휴사2 내역

SUM_28

Number

합계 내역

SUM_33

Number

정산 합계 내역

정산내역 조회 - 제휴사

POST /api/point/listOprcoTstPintMmSumr

HTTP request

POST /api/point/listOprcoTstPintMmSumr HTTP/1.1
Content-Type: application/json;charset=UTF-8
x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA
Content-Length: 81
Host: {url}

{
	"COOPCO_CD" : "7000",
	"CLOSE_YEARMM" : "202109",
	"BRND_CD" : "1000"
}
							

Curl request

$ curl 'http://{url}/api/point/listOprcoTstPintMmSumr' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'x-auth-token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI3MDAwIiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTYzNjg2NjUxOX0.dkhLMPlfsrddBBKq1B0UtG1BQOgCa6_qW6sz8SQHrqA' \
    -d '{
  "COOPCO_CD" : "7000",
  "CLOSE_YEARMM" : "202109",
  "BRND_CD" : "1000"
}'
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

COOPCO_CD

String

운영사 코드

BRND_CD

String

제휴사 코드

CLOSE_YEARMM

String

조회 년/월 'YYYYMM'

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2611

{
	"resultCode" : "S0000",
	"resultMessage" : "정상 처리 되었습니다.",
	"resultData" : {
		"RESULTS" : [ {
			"GUBUN_2" : "일반",
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : "적립 계",
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립취소"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : null,
			"SUM_12" : 7156,
			"GUBUN_4" : null,
			"GUBUN_1" : "적립 계(적립취소 반영)"
		}, {
			"GUBUN_2" : "회원탈퇴소멸",
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "유효기간경과소멸",
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : "소멸 계",
			"GUBUN_3" : null,
			"SUM_12" : 0,
			"GUBUN_4" : null,
			"GUBUN_1" : "소멸"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "POINT",
			"SUM_12" : 945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : 3000,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "사용 계",
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : "사용 계",
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "POINT",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "COFFEE",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : "사용취소 계",
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : "사용취소 계",
			"GUBUN_3" : null,
			"SUM_12" : null,
			"GUBUN_4" : null,
			"GUBUN_1" : "전월사용분의 당월 취소건"
		}, {
			"GUBUN_2" : null,
			"GUBUN_3" : null,
			"SUM_12" : 3945,
			"GUBUN_4" : null,
			"GUBUN_1" : "사용 계(사용취소(전월)반영)"
		} ]
	}
}
							

Response fields

Path Type Optional Description

resultCode

String

처리 결과 코드

resultMessage

String

처리 결과 메시지

resultData

Array

처리 결과

Response fields-resultdata-results

Path Type Optional Description

GUBUN_1

String

1DEPTH

GUBUN_2

String

2DEPTH

GUBUN_3

Null

3DEPTH

GUBUN_4

Null

4DEPTH

SUM_12

Number

제휴사1 내역

NFT

NFT의 생성, 발행, 조회 API를 제공합니다.

NFT 생성

POST /v1/api/services/nft/bers/{networkId}/deploy
  • NFT 발행할 Smart Contract를 생성한다.

HTTP request

POST /v1/api/services/nft/bers/106/deploy HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8
Content-Length: 33

{
  "contentName": "contentName"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/nft/bers/106/deploy' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8' \
--data-raw '{
  "contentName": "contentName"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

contentName

String

NFT 상품명

HTTP response

{
  "status": 200,
  "data": {
    "id": 696,
    "contentName": "contentName",
    “deployUuid": "66c0eeaf-ab22-4057-8dbc-ca66ea9d1a47"
  },
  "code": "C000",
  "message": "Success",
  "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

id

Number

리턴 코드

deployUuid

String

NFT 생성 코드(uuid)

contentName

String

생성된 Smart Contract명

NFT 발행

POST /v1/api/services/nft/bers/{networkId}/mint
  • 생성된 Smart Contract에 토큰을 발행한다.

HTTP request

POST /v1/api/services/nft/bers/106/mint HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8
Content-Length: 173

{
  "deployUuid": "66c0eeaf-ab22-4057-8dbc-ca66ea9d1a47",
  "contentUrl": "contentUrl",
  "ownerAddress": "0af563e000213ce5cf2114b481d841883befd5e5",
  "mintCount": 1
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/nft/bers/106/mint' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8' \
--data-raw '{
  "deployUuid": "66c0eeaf-ab22-4057-8dbc-ca66ea9d1a47",
  "contentUrl": "contentUrl",
  "ownerAddress": "0af563e000213ce5cf2114b481d841883befd5e5",
  "mintCount": 1
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

deployUuid

String

NFT 생성 코드(uuid)

contentUrl

String

NFT 발행 Url

ownerAddress

String

NFT 발행할 지갑 주소

mintCount

Number

O

발행 갯수

HTTP response

{
    "status": 200,
    "data": {
        "mintUuid": [
            "ff87a71c-9428-47f2-a536-fb482e324c72"
        ],
        "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
        "contentName": "contentName"
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}

							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

mintUuid

List<String>

NFT 발행 코드 리스트(uuid)

deployUuid

String

NFT 생성 코드(uuid)

contentName

String

생성된 Smart Contract명

보유 NFT 조회

POST /v1/api/services/nft/bers/{networkId}/balanceOf
  • 발행된 토큰을 조회한다.

HTTP request

POST /v1/api/services/nft/bers/106/balanceOf HTTP/1.1
Host: 52.79.40.7:3000
Content-Type: application/json
Authorization: Bearer 2c37f203-b2a5-4a9b-ab21-2296183bb0b4
Content-Length: 214

{
  "ownerAddress": "0af563e000213ce5cf2114b481d841883befd5e5",
  "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
  "pageNumber": 0,
  "pageSize": 0,
  "sortBy": "tokenId:ASC",
  "state": "CONFIRMED"
}
							

Curl request

curl --location --request POST 'http://52.79.40.7:3000/v1/api/services/nft/bers/106/balanceOf' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 2c37f203-b2a5-4a9b-ab21-2296183bb0b4' \
--data-raw '{
  "ownerAddress": "0af563e000213ce5cf2114b481d841883befd5e5",
  "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
  "pageNumber": 0,
  "pageSize": 0,
  "sortBy": "tokenId:ASC",
  "state": "CONFIRMED"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

ownerAddress

String

소유주 지갑 주소

deployUuid

String

O

NFT 생성 코드(uuid)

pageNumber

Number

O

페이지 번호

pageSize

Number

O

페이지 사이즈

sortBy

String

O

정렬 기준

state

String

O

상태 조건

HTTP response

{
    "status": 200,
    "data": {
        "tokenList": [
            {
                "contentName": "contentName",
                "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
                "uuid": "ff87a71c-9428-47f2-a536-fb482e324c72",
                "state": "CONFIRMED",
                "mintNumber": 1,
                "deployCreateAt": "2022-03-16 16:23:34",
                "deployConfirmedAt": "2022-03-16 16:23:48",
                "mintCreateAt": "2022-03-16 17:11:27",
                "mintConfirmedAt": "2022-03-16 17:11:43",
                "createAt": "2022-03-16 17:11:27",
                "confirmedAt": "2022-03-16 17:11:43"
            }
        ],
        "totalCount": 1,
        "size": 10,
        "page": 0
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

tokenList

List<Object>

보유 토큰 리스트

totalCount

Number

총 보유 토큰 갯수

size

Number

페이지 사이즈

page

Number

페이지 번호

Response fields-data-tokenList

Path Type Optional Description

contentName

String

생성된 Smart Contract명

deployUuid

String

NFT 생성 코드(uuid)

uuid

String

NFT 발행/이관 코드(uuid)

state

String

토큰 상태 코드

mintNumber

Number

발행된 토큰의 Id

deployCreateAt

Date

Smart Contract 생성 요청 일시

deployConfirmedAt

Date

Smart Contract 생성 완료 일시

mintCreateAt

Date

NFT 최초 발행 요청 일시

mintConfirmedAt

Date

NFT 최초 발행 완료 일시

createAt

Date

NFT 발행/이관 요청 일시

confirmedAt

Date

NFT 발행/이관 완료 일시

NFT 소유주 조회

POST /v1/api/services/nft/bers/{networkId}/ownerOf
  • 발행된 토큰의 소유주를 조회한다.

HTTP request

POST //v1/api/services/nft/bers/106/ownerOf HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8
Content-Length: 111

{
  "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
  "uuid": "ff87a71c-9428-47f2-a536-fb482e324c72"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co//v1/api/services/nft/bers/106/ownerOf' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8' \
--data-raw '{
  "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
  "uuid": "ff87a71c-9428-47f2-a536-fb482e324c72"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

deployUuid

String

NFT 생성 코드(uuid)

uuid

String

NFT 발행/이관 코드(uuid)

HTTP response

{
    "status": 200,
    "data": {
        "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
        "contentName": "contentName",
        "ownerAddress": "0af563e000213ce5cf2114b481d841883befd5e5",
        "tokenUuid": "ff87a71c-9428-47f2-a536-fb482e324c72"
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

deployUuid

String

NFT 생성 코드(uuid)

contentName

String

생성된 Smart Contract명

ownerAddress

String

소유주 지갑주소

tokenUuid

String

NFT 발행/이관 코드(uuid)

NFT 소유주 변경

POST /v1/api/services/nft/bers/{networkId}/tranferFrom
  • 발행된 토큰의 소유주를 변경한다.

HTTP request

POST /v1/api/services/nft/bers/106/transferFrom HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8
Content-Length: 241

{
    "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
    "nftSendFrom": "0af563e000213ce5cf2114b481d841883befd5e5",
    "nftSendTo": "e7aa0680cda4b22dbdd3bafc7f7b611215a2110b",
    "uuid": "ff87a71c-9428-47f2-a536-fb482e324c72"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/nft/bers/106/transferFrom' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8' \
--data-raw '{
    "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
    "nftSendFrom": "0af563e000213ce5cf2114b481d841883befd5e5",
    "nftSendTo": "e7aa0680cda4b22dbdd3bafc7f7b611215a2110b",
    "uuid": "ff87a71c-9428-47f2-a536-fb482e324c72"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

deployUuid

String

NFT 생성 코드(uuid)

nftSendFrom

String

이전 NFT 토큰 소유주 지갑 주소

nftSendTo

String

받는 NFT 토큰 소유주 지갑 주소

uuid

String

NFT 발행/이관 코드(uuid)

HTTP response

{
    "status": 200,
    "data": {
        "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
        "contentName": "contentName",
        "transferUuid": "1ac74b48-680a-4e98-97d4-e50e7903f198"
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

deployUuid

String

NFT 생성 코드(uuid)

contentName

String

생성된 Smart Contract명

transferUuid

String

NFT 이관 코드(uuid)

NFT 토큰URI 조회

POST /v1/api/services/nft/bers/{networkId}/tokenUri
  • 발행된 토큰의 URI를 조회한다.

HTTP request

POST /v1/api/services/nft/bers/106/tokenUri HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8
Content-Length: 115

{
    "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
    "uuid": "1ac74b48-680a-4e98-97d4-e50e7903f198"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/nft/bers/106/tokenUri' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8' \
--data-raw '{
    "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
    "uuid": "1ac74b48-680a-4e98-97d4-e50e7903f198"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

deployUuid

String

NFT 생성 코드(uuid)

uuid

String

NFT 발행/이관 코드(uuid)

HTTP response

{
    "status": 200,
    "data": {
        "contentUrl": "contentUrl",
        "contentName": "NFT test",
        "state": "CONFIRMED",
        "deployUuid": "6a83b20e-d76a-43aa-a102-3d031fec275c",
        "deployCreatedAt": "2022-03-16 16:23:34",
        "deployConfirmedAt": "2022-03-16 16:23:48",
        "txHash": "0x240f401a1b3a83b59529f945c6afd82641008eea4f9d9cfb1ce415a5cc57d701",
        "mintNumber": 1,
        "mintCreatedAt": "2022-03-16 17:11:27",
        "mintConfirmedAt": "2022-03-16 17:11:43",
        "transferCreatedAt": "2022-03-16 18:00:11",
        "transferConfirmedAt": "2022-03-16 18:00:23"
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

contentUrl

String

NFT 발행 Url

contentName

String

Smart Contract명

state

String

O

상태

deployUuid

String

NFT 생성 코드(uuid)

deployCreatedAt

Date

Smart Contract 생성 요청 일시

deployConfirmedAt

Date

Smart Contract 생성 완료 일시

txHash

String

Transaction Hash

mintNumber

Number

발행된 토큰의 Id

mintCreatedAt

Date

NFT 최초 발행 요청 일시

mintConfirmedAt

Date

NFT 최초 발행 완료 일시

transferCreatedAt

Date

NFT 이관 요청 일시

transferConfirmedAt

Date

NFT 이관 완료 일시

NFT Tx 조회

POST /v1/api/services/nft/bers/{networkId}/transaction
  • NFT항목에서 발생시킨 Transaction 정보를 조회한다.

HTTP request

POST /v1/api/services/nft/bers/106/transaction HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer 2c37f203-b2a5-4a9b-ab21-2296183bb0b4
Content-Length: 54

{
  "uuid": "1ac74b48-680a-4e98-97d4-e50e7903f198"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/nft/bers/106/transaction' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 2c37f203-b2a5-4a9b-ab21-2296183bb0b4' \
--data-raw '{
  "uuid": "1ac74b48-680a-4e98-97d4-e50e7903f198"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

uuid

String

NFT 발행/이관 코드(uuid)

HTTP response

{
    "status": 200,
    "data": {
        "uuid": "1ac74b48-680a-4e98-97d4-e50e7903f198",
        "txHash": "0x240f401a1b3a83b59529f945c6afd82641008eea4f9d9cfb1ce415a5cc57d701",
        "state": "CONFIRMED"
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

uuid

String

NFT 발행/이관 코드(uuid)

txHash

String

Transaction Hash

state

String

상태

전자계약

스마트 컨트랙트 연동을 통한 전자계약 API를 제공합니다.

전자계약등록

POST /v1/api/services/dss/bers/{networkId}
  • 전자계약을 신규 등록한다.

HTTP request

POST /v1/api/services/dss/bers/106 HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer 2c37f203-b2a5-4a9b-ab21-2296183bb0b4
Content-Length: 22

{
  "data": "data"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/dss/bers/106' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 2c37f203-b2a5-4a9b-ab21-2296183bb0b4' \
--data-raw '{
  "data": "data"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

data

String

계약 데이터(문서)

HTTP response

{
    "status": 200,
    "data": {
        "id": 57064,
        "uuid": "ba74f149-bed5-4c89-880d-7bb03e3d9f39",
        "keyTag": "tag"
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

id

Number

리턴 ID

uuid

String

데이터 맵핑 uuid

keyTag

String

해당 계정 정보

계약조회

POST /v1/api/services/dss/bers/{networkId}/search
  • 전자계약된 정보를 조회한다.

HTTP request

POST /v1/api/services/dss/bers/106/search HTTP/1.1
Host: baas.berith.co
Content-Type: application/json
Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8
Content-Length: 73

{
  "uuid": "ba74f149-bed5-4c89-880d-7bb03e3d9f39"
}
							

Curl request

curl --location --request POST 'https://baas.berith.co/v1/api/services/dss/bers/106/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer b551de50-cc6d-40e3-887d-72a1d5e910f8' \
--data-raw '{
  "uuid": "ba74f149-bed5-4c89-880d-7bb03e3d9f39"
}'
							

Request headers

Name Description

Content-Type

application/json

Authorization

OAuth2.0 토큰

Request fields

Path Type Optional Description

uuid

String

데이터 맵핑 uuid

HTTP response

{
    "status": 200,
    "data": {
        "uuid": "9fa5bec1-3de9-4c75-94ba-22b3b2b08c83",
        "state": "CONFIRMED",
        "transaction": {
            "blockHash": "0x83692476e954a7c03b8371e2cdf0bfbe789eee0487ef67f3d4a8c95ed81f172e",
            "blockNumber": "0x53c5e2",
            "blockTimestamp": 1647477968,
            "from": "Bx36e2d6d95614a88a003966f67c4096b0924ef4e2",
            "gas": "0x7a120",
            "gasPrice": "0x3b9aca00",
            "hash": "0xc7f5157a5f24dac9dd62b995f1b659a8dc9106355249ad796f2b03ea29e7294d",
            "input": "1f9ffce8000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000005000000000000000000000000000000000000000000000000000000000000002462613734663134392d626564352d346338392d383830642d3762623033653364396633390000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000046461746100000000000000000000000000000000000000000000000000000000",
            "nonce": "0xde38",
            "to": "Bx9654f820603d98841ddba3d5c42cb5a1c5552a75",
            "transactionIndex": "0x0",
            "value": "0x0",
            "base": "MAIN",
            "target": "MAIN",
            "v": 247,
            "r": "0xe2d96b37795008768c0844f187f8a710d137f4dda8c036d2668e121241e50fdb",
            "s": "0x262a52540c077be9722a83d58b6f2d4d19abe9ab8bd196bc10c99a7cf86850a0"
        },
        "txHash": ""
    },
    "code": "C000",
    "message": "Success",
    "errors": []
}
							

Response fields

Path Type Optional Description

status

Number

응답코드

code

String

처리 결과 코드

Message

String

처리 결과 메세지

data

Object

처리 결과

Response fields-data

Path Type Optional Description

uuid

String

데이터 맵핑 uuid

state

String

Transaction 상태

transaction

Object

Transaction 정보

Response fields-data-transaction

Path Type Optional Description

blockHash

String

생성된 Block Hash값

blockNumber

String

생성된 Block Number

blockTimestamp

Number

Block 생성 시간 (UTC)

from

String

계약 지갑 주소

gas

String

사용된 gas 값

gasPrice

String

사용된 gas 값

hash

String

Transaction Hash값

input

String

Transaction에 담긴 데이터

nonce

String

계약번호

to

String

Smart Contract 주소

trancationIndex

String

Transaction index값

value

String

value

base

String

base

target

String

target

v

Number

서명값 v

r

String

서명값 v

s

String

서명값 s

Enterprise

블록체인 설치부터 관리, 모니터링을 위한 블록체인 구축 API 입니다.

네트워크 생성

POST /install/saveNetworkSetup
  • 네트워크를 생성한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

BLOCKCHAIN_NAME

String

네트워크 명(블록체인)

HTTP response

내용없음
							

계정생성

POST /install/createAccount
  • 계정을 생성한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

ACCOUNT_PASSWORD

String

계정 비밀번호

BLOCKCHAIN_HOST_ID

String

네트워크 Host Id

BLOCKCHAIN_SETUP_ID

String

네트워크 설치 Id

IS_MINER

Boolean

Miner 여부

HTTP response

내용없음
							

Response fields

Path Type Optional Description

ACCOUNT_ADDRESS

String

계정 주소

체인생성

POST /install/saveSpecification
  • 체인을 생성한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

BLOCKCHAIN_SPECIFICATION

Object

네트워크 사양

IS_PRIVATE_BLOCKCHAIN

Boolean

프라이빗 네트워크 여부

CONSENSUS_ENGINE

String

합의 엔진

EPOCH

String

EPOCH

BLOCKCHAIN_DETAILS_ID

String

네트워크 상세 Id

Request fields-BLOCKCHAIN_SPECIFICATION

Path Type Optional Description

config

Object

네트워크 구성

difficulty

String

난이도

gasLimit

String

가스 제한

coinbase

String

coinbase

parentHash

String

parentHash

extraData

String

extraData

nonce

String

nonce

mixHash

String

mixHash

alloc

String

alloc

Request fields-BLOCKCHAIN_SPECIFICATION-config

Path Type Optional Description

chainId

String

체인 Id

HTTP response

내용없음
							

Response fields

Path Type Optional Description

CONSENSUS_ENGINE

String

합의 엔진

체인생성 조회

GET /hosts/addPeerStep1
  • 생성된 체인 정보를 조회한다.

HTTP request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

HTTP response

내용없음
							

Response fields

Path Type Optional Description

hosts

List<Host>

hosts

networks

List<BlockchainDetails>

체인 목록

Response fields-Host

Path Type Optional Description

hostId

String

Host Id

name

String

Name

address

String

주소

username

String

유저명

password

String

패스워드

privateKey

String

프라이빗 키

port

String

Port

Response fields-BlockchainDetails

Path Type Optional Description

blockchainDetailsId

String

체인 Id

isPublic

Boolean

공개 여부

blockchainType

String

네트워크(블록체인) 타입

blockchainNetwork

String

네트워크(블록체인) Id

blockchainSpecifications

String

네트워크(블록체인) 사양

consensusEngine

String

합의 엔진

state

String

상태

blockchainSetup

BlockchainSetup

네트워크(블록체인) 설치 정보

updatedAt

Date

수정 날짜

Response fields-BlockchainDetails-BlockchainSetup

Path Type Optional Description

blockchainSetupId

String

네트워크 설치 Id

blockchainName

String

네트워크 명

노드추가

GET /hosts/addPeerStep2
  • 노드를 추가한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

blockchainHostId

String

네트워크 Host Id

HTTP response

내용없음
							

Response fields

Path Type Optional Description

BLOCKCHAIN_SETUP_ID

String

네트워크 설치 ID

BLOCKCHAIN_HOST_ID

String

HOST ID

IS_MINER

String

Miner 여부

Wallet

다양한 암호화폐를 보관/거래할 수 있는 멀티 지갑을 지원하는 API 입니다.

지갑생성

POST /member/createMmbWlt.do
  • 지갑정보를 신규 등록 한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

ACC_TKN

String

엑세스토큰

BLKCHN_DV_CD

String

블록체인 구분 코드

WLT_NM

String

지갑 명

WLT_ADDR

String

지갑 주소

RLSE_YN

String

공개 여부

PRVT_KY

String

프라이빗 키

PRVT_KY_SRVR_SAVE_YN

String

프라이빗 키 서버 저장 여부

HTTP response

내용없음
							

Response fields

Path Type Optional Description

RSLT_CD

String

결과 코드

RSLT_MSG

String

결과 메세지

조회

POST /member/searchWalletList.do
  • 지갑리스트를 조회 한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

MMB_ID

String

회원 ID

MBLE_TEL_NO

String

모바일 전화번호

MBLE_TEL_CNTY_NO

Number

모바일 전화 국가 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

WLT_LIST

Object

지갑 리스트

Response fields-WLT_LIST

Path Type Optional Description

WLT_IDX

Number

지갑 순번

BLKCHN_DV_CD

String

블록체인 구분 코드

WLT_ADDR

String

지갑 주소

PRVT_KY

String

프라이빗 키

Pay

암호화폐 지불결제 서비스를 지원하는 API 입니다.

결제 처리

POST /pay/off/paymentInfo.do
  • 결제 처리

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

AccTkn

String

엑세스토큰

IntfVersn

String

인터페이스버전

SttlNum

String

결제번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

RsltCd

String

결과코드

RsltMsg

String

결과 메시지

결제내역조회

POST /pay/off/searchOfflinePayDetail
  • 결제내역을 조회한다.

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

x-auth-token

토큰

Request fields

Path Type Optional Description

IntfVersn

String

인터페이스버전

TRSC_NO

String

블록체인 거래번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

RsltCd

String

결과코드

RsltMsg

String

결과 메시지

전자투표

투표 정보 저장

POST /api/v1/vote/voteInfoSave
  • 투표 정보 저장

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

agenda

Object

투표 안건

question

Object

투표 질문

answer

Object

투표 답변

Request fields-agenda

Path Type Optional Description

voteNo

String

투표 번호

voteSe

String

투표 구분

voteSj

String

투표 제목

voteDc

String

투표 설명

othbcTrget

String

공개 대상

trgetSourc

String

대상 소스

voteSttus

String

투표 상태

beginDt

String

시작 일시

endDt

String

종료 일시

statsColctYn

String

통계 수집 가부

voteLang

String

투표 언어

progrsMiddlResult

String

진행 중 결과

closNtcnYn

String

마감 알림 가부

ntcnMoblphonNo

String

알림 핸드폰 번호

linkUrl

String

링크URL

voteTy

String

투표 타입

mxmmChoiseCo

String

최대 선택 수

voteCrtr

String

투표 생성자

answerYn

String

댓글 가부

votePassword

String

투표 비밀번호

qestnCo

String

질문 수

imageFilenm

String

이미지 파일명

imageRealFlpth

String

이미지 실제 파일경로

imageWebFlpth

String

이미지웹 파일경로

popupDocId

String

팝업 문서 아이디

register

String

등록자

registDt

String

등록 일시

eventSeq

String

이벤트 일련

refrnVote

String

참조 투표

voteIndictTy

String

투표 표시 타입

qestnRandomYn

String

질문 무작위 여부

voteDetailSj

String

투표 상세 제목

mxmmVoteCo

String

최대 투표 수

policyVoteTy

String

정책 투표 타입

voteInqireTy

String

투표 조회 타입

apiRegisterMoblphonNo

String

API 등록자 핸드폰 번호

apiUserId

String

API 사용자 아이디

Request fields-question

Path Type Optional Description

qestnSeq

String

질문 일련

qestnSj

String

질문 제목

qestnSe

String

질문 구분

answerCo

String

답변 수

mxmmChoiseCo

String

최대 선택 수

answerRandomYn

String

답변 무작위 가부

register

String

등록자

registDt

String

등록 일시

mummChoiseCo

String

최소 선택 수

nextQestnSeq

String

다음 질문 일련

Request fields-answer

Path Type Optional Description

qestnSeq

String

질문 일련

answerSeq

String

답변 일련

answer

String

답변

prtcpntCo

String

참여자 수

imageFilenm

String

이미지 파일명

imageRealFlpth

String

이미지 실제 파일경로

imageWebFlpth

String

이미지웹 파일경로

popupYn

String

팝업 가부

popupSj

String

팝업 제목

popupCn

String

팝업 내용

popupDocId

String

팝업 문서 아이디

register

String

등록자

registDt

String

등록 일시

nextQestnSeq

String

다음 질문 일련

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

투표 정보 조회

POST /api/v1/vote/voteInfoSelect
  • 투표 완료 후 정보 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

voteNo

String

투표 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

agenda

Object

투표 안건

question

Object

투표 질문

answer

Object

투표 답변

Response fields-agenda

Path Type Optional Description

voteNo

String

투표 번호

voteSe

String

투표 구분

voteSj

String

투표 제목

voteDc

String

투표 설명

othbcTrget

String

공개 대상

trgetSourc

String

대상 소스

voteSttus

String

투표 상태

beginDt

String

시작 일시

endDt

String

종료 일시

statsColctYn

String

통계 수집 가부

voteLang

String

투표 언어

progrsMiddlResult

String

진행 중 결과

closNtcnYn

String

마감 알림 가부

ntcnMoblphonNo

String

알림 핸드폰 번호

linkUrl

String

링크URL

voteTy

String

투표 타입

mxmmChoiseCo

String

최대 선택 수

voteCrtr

String

투표 생성자

answerYn

String

댓글 가부

votePassword

String

투표 비밀번호

qestnCo

String

질문 수

imageFilenm

String

이미지 파일명

imageRealFlpth

String

이미지 실제 파일경로

imageWebFlpth

String

이미지웹 파일경로

popupDocId

String

팝업 문서 아이디

register

String

등록자

registDt

String

등록 일시

eventSeq

String

이벤트 일련

refrnVote

String

참조 투표

voteIndictTy

String

투표 표시 타입

qestnRandomYn

String

질문 무작위 여부

voteDetailSj

String

투표 상세 제목

mxmmVoteCo

String

최대 투표 수

policyVoteTy

String

정책 투표 타입

voteInqireTy

String

투표 조회 타입

apiRegisterMoblphonNo

String

API 등록자 핸드폰 번호

apiUserId

String

API 사용자 아이디

Response fields-question

Path Type Optional Description

qestnSeq

String

질문 일련

qestnSj

String

질문 제목

qestnSe

String

질문 구분

answerCo

String

답변 수

mxmmChoiseCo

String

최대 선택 수

answerRandomYn

String

답변 무작위 가부

register

String

등록자

registDt

String

등록 일시

mummChoiseCo

String

최소 선택 수

nextQestnSeq

String

다음 질문 일련

Response fields-answer

Path Type Optional Description

qestnSeq

String

질문 일련

answerSeq

String

답변 일련

answer

String

답변

prtcpntCo

String

참여자 수

imageFilenm

String

이미지 파일명

imageRealFlpth

String

이미지 실제 파일경로

imageWebFlpth

String

이미지웹 파일경로

popupYn

String

팝업 가부

popupSj

String

팝업 제목

popupCn

String

팝업 내용

popupDocId

String

팝업 문서 아이디

register

String

등록자

registDt

String

등록 일시

nextQestnSeq

String

다음 질문 일련

투표 대상자 저장

POST /api/v1/vote/voteTargetPersonSave
  • 투표 가능 대상자 저장

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

voteNo

String

투표 번호

targetPerson

Object

투표 대상자

Request fields-targetPerson

Path Type Optional Description

voteNo

String

투표 번호

voteTrgterSeq

String

투표 대상자 일련

trgetSourc

String

대상 소스

voteTrgterNm

String

투표 대상자 명

moblphonNo

String

휴대폰 번호

voteYn

String

투표 가부

register

String

등록자

registDt

String

등록 일시

srvcUserId

String

서비스 사용자 아이디

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

투표 대상자 조회

POST /api/v1/vote/voteTargetPersonSelect
  • 투표 가능 대상자 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

voteNo

String

투표 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

voteNo

String

투표 번호

targetPerson

Object

투표 대상자

Response fields-targetPerson

Path Type Optional Description

voteNo

String

투표 번호

voteTrgterSeq

String

투표 대상자 일련

trgetSourc

String

대상 소스

voteTrgterNm

String

투표 대상자 명

moblphonNo

String

휴대폰 번호

voteYn

String

투표 가부

register

String

등록자

registDt

String

등록 일시

srvcUserId

String

서비스 사용자 아이디

투표 내역 저장

POST /api/v1/vote/{traceGroupId}/event
  • 투표한 내역을 저장

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

voteNo

String

투표 번호

srvcUserId

String

서비스 사용자 아이디

voteHistory

Array

투표 내역

Request fields-voteHistory

Path Type Optional Description

qestnSeq

String

질문 일련

answerSeq

String

답변 일련

srvcUserId

String

서비스 사용자 아이디

moblphonNo

String

휴대폰 번호

voteChnnl

String

투표 채널

sbjctAnswer

String

주관식 답변

registDt

String

등록 일시

register

String

등록자

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

투표 내역 조회

POST /api/v1/vote/voteHistorySelect
  • 투표한 내역을 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

voteNo

String

투표 번호

srvcUserId

String

O

서비스 사용자 아이디

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

voteHistory

Array

투표 내역

Response fields-voteHistory

Path Type Optional Description

voteNo

String

투표 번호

qestnSeq

String

질문 일련

answerSeq

String

답변 일련

srvcUserId

String

서비스 사용자 아이디

moblphonNo

String

휴대폰 번호

voteChnnl

String

투표 채널

sbjctAnswer

String

주관식 답변

registDt

String

등록 일시

투표 참여 이력 조회

POST /api/v1/vote/voteJoinHistorySelect
  • 투표한 참여자 이력을 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

srvcUserId

String

서비스 사용자 아이디

voteNo

String

O

투표 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

voteJoinHistory

Array

투표 참여 내역

Response fields-voteJoinHistory

Path Type Optional Description

voteNo

String

투표 번호

srvcUserId

String

서비스 사용자 아이디

moblphonNo

String

휴대폰 번호

register

String

등록자

registDt

String

등록 일시

voteChnnl

String

투표 채널

투표 집계 결과 조회

POST /api/v1/vote/voteTotalResultSelect
  • 완료된 투표의 결과를 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

voteNo

String

투표 번호

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

voteNo

String

투표 번호

qestnSeq

String

질문 일련

qestnSj

String

질문 제목

answerSeq

String

답변 일련

answer

String

답변

answerTot

String

답변 통계

srvcUserId

String

서비스 사용자 아이디

sbjctAnswer

String

주관식 답변

imageFilenm

String

이미지 파일명

imageRealFlpth

String

이미지 실제 파일경로

imageWebFlpth

String

이미지웹 파일경로

popupYn

String

팝업 가부

popupSj

String

팝업 제목

popupCn

String

팝업 내용

popupDocId

String

팝업 문서 아이디

register

String

등록자

registDt

String

등록 일시

nextQestnSeq

String

다음 질문 일련

파일 정보 저장

POST /api/v1/vote/voteFileInfoSave
  • 투표 파일의 정보를 저장

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

fileInfo

Object

파일정보

Request fields-fileInfo

Path Type Optional Description

fileId

String

파일 아이디

docId

String

문서 아이디

fileNm

String

파일 명

fileExtsnNm

String

파일 확장자 명

fileSize

String

파일 사이즈

filePartnCours

String

파일 상대 경로

fileAbsltCours

String

파일 절대 경로

cntntsTy

String

컨텐츠 유형

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

파일 정보 조회

POST /api/v1/vote/voteFileInfoSelsct
  • 투표 파일의 정보를 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

fileId

String

파일 아이디

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

fileInfo

Object

파일 정보

Response fields-fileInfo

Path Type Optional Description

fileId

String

파일 아이디

docId

String

문서 아이디

fileNm

String

파일 명

fileExtsnNm

String

파일 확장자 명

fileSize

String

파일 사이즈

filePartnCours

String

파일 상대 경로

fileAbsltCours

String

파일 절대 경로

cntntsTy

String

컨텐츠 유형

추첨

Event Group 목록 조회

GET /api/v1/event-groups
  • Event Group 목록 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

eventGroupId

String

이벤트 그룹 ID

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

eventGroups

Array

이벤트 그룹 목록

Event Group Condition 조회

GET /api/v1/event-group/{eventGroupId}
  • Event Group Condition 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

eventGroup

Object

이벤트 그룹

Event Group Condition 등록

PUT /api/v1/event-group
  • Event Group Condition 등록

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

Event 응모자 목록 조회

GET /api/v1/event-entrys/{eventGroupId}
  • Event 응모자 목록 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

eventEntrys

Array

이벤트 응모자 목록

Event 응모정보 조회

POST /api/v1/event-entry/{eventEntryId}
  • Event 응모정보 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

eventEntry

Object

이벤트 응모 정보

Event 응모

PUT /api/v1/event/voteHistorySelect
  • Event 응모

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

O

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

Event 당첨자 목록 조회

GET /api/v1/event-draws/{eventGroupId}
  • Event 당첨자 목록 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

Event 당첨자 추첨

POST /api/v1/event-draw/{eventGroupId}
  • Event 당첨자 추첨

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

이력추적

Trace Group 목록 조회

GET /api/v1/trace-groups
  • Trace Group 목록 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

traceGroups

Array

관리되는 Trace 그룹

Trace Group의 상태 조회

GET /api/v1/trace-group/{traceGroupId}
  • Trace Group의 상태 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

traceGroupId

String

Trace 그룹 ID

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

traceGroup

Object

Trace 그룹 정보

Trace Group에서 발생한 이벤트 목록 조회

GET /api/v1/trace-group/{traceGroupId}/events
  • Trace Group에서 발생한 이벤트 목록 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

events

Array

Trace 그룹에서 발생한 Event 목록

Trace Group에서 발생한 이벤트 상세 조회

POST /api/v1/trace-group/{traceGroupId}/event/{evntId}
  • Trace Group에서 발생한 이벤트 상세 조회

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

event

Object

발생한 이벤트 정보

기록된 Event 검증

POST /api/v1/trace-group/{traceGroupId}/event-varify/{evntId}
  • 기록된 Event 검증

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

내용없음

내용없음

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

Event 기록

POST /api/v1/trace-group/{traceGroupId}/event
  • Event 기록

HTTP request

내용없음
							

Curl request

내용없음
							

Request headers

Name Description

Content-Type

application/json

Request fields

Path Type Optional Description

traceGroupId

String

Trace 그룹 ID

refId

String

관련 ID

eventName

String

Event 명

userName

String

유저명

data

String

Event Data

HTTP response

내용없음
							

Response fields

Path Type Optional Description

errCd

String

응답코드

Response fields-voteHistory

Path Type Optional Description

voteNo

String

투표 번호

qestnSeq

String

질문 일련

answerSeq

String

답변 일련

srvcUserId

String

서비스 사용자 아이디

moblphonNo

String

휴대폰 번호

voteChnnl

String

투표 채널

sbjctAnswer

String

주관식 답변

registDt

String

등록 일시