API 안내
- One ID API 는 기업회원만 사용 가능 합니다.
- One ID API 사용을 위한 인증키는 기업회원 신청시 자동신청 됩니다.
기업회원 신청 후 마이페이지 에서 확인 하실 수 있습니다.
One ID인증 API란?

Oauth2 기반의 Hdac가치포털로 로그인하기 기능은 '구글로 로그인' 또는 '카카오로 로그인' 처럼, Hdac가치포털에 로그인한 사용자가 Hdac가치포털에 제공한 데이터들 (E-mail 등) 을 외부 사이트 (Hdac가치포털로 로그인 하기 기능을 사용하실 사이트) 에서 가져갈 수 있도록 합니다.

P2P정보, 상품안내 API란?

P2P정보(상품), 상품정보, 기업회원 API 개발을 통하여 귀사의 상품을 판매자들이 손쉽게 주문 할 수 있는 환경을 제공 합니다.


Hdac가치포털 API 이용절차
One ID인증 API 활용안내

- Hdac가치포털로 로그인 oauth2 설정 방법

1. client 등록

외부 사이트를 oauth2 에서는 client 라고 칭합니다. Hdac가치포털에 사이트(기업회원)를 등록합니다.

2. Hdac가치포털 측에 넘겨줘야 하는 데이터

* redirect_uri

Oauth2 인증 과정에서, 사용자가 Hdac가치포털에 로그인 되어있음을 확인하면 Hdac가치포털는 이 사용자를 제공해주시는 redirect_uri 로 redirect 합니다. 제공해주신 uri 로만 redirect 가 가능합니다.

3. Hdac가치포털 측에서 제공하는 데이터

Hdac가치포털측에서 redirect_uri 를 등록하고 client_id, client_secret 를 알려드립니다. 이 값들로 사이트를 인증하니 외부 유출이 안되도록 주의하여 주시기 바랍니다.

4. Hdac가치포털로 로그인을 구현하기 위한 Rest flow

Code 얻기
request

GET /oauth/authorize?client_id={client_id}&redirect_uri={redirect_uri}&response_type=code&scope=read&state={state}

client_id : 등록시 발급받습니다.
redirect_uri : redirect 될 주소입니다.
response_type : code 로 static 입니다.
state : Cross-site Request Forgery 를 위한 값입니다, redirect 시 같은 값을 돌려줍니다.
scope : read 로 static 입니다.

- response

{redirect_uri}?code={authorize_code}&state={state}

- User access token 얻기
- request

POST /oauth/token
'Accept': 'application/json', 'Content-Type': 'application/x-www-form-urlencoded'

grant_type : authorization_code 으로 static 입니다.
client_id : 등록시 발급됩니다.
redirect_uri : redirect uri 입니다
code : 위에서 얻은 code 값입니다.
client_secret : 등록시 발급됩니다.

- response
--------
{ 'access_token': {access_token}, ‘user_email’: {user_email}}

User_email 을 사용합니다.

REST flow 를 쉽게 구현하도록 Oauth2 client 라이브러리를 사용할 수 있습니다.

Oauth2 client 라이브러리 설치
===========================================================================================================

google/facebook 등으로 로그인 기능을 구현해보신 적이 있으시다면, oauth2 client 라이브러리를 사용하셨을 겁니다.
서버 언어별로 oauth2 client 라이브러리들이 많이 있으니, 이중에 골라서 사용하시면 됩니다. (https://oauth.net/code/)

5. Oauth2 client 라이브러리 설정

라이브러리 설치후, 다음과 같은 설정이 필요합니다.

authorization url
* {BASE_URL}/oauth/authorize
* oauth2 라이브러리가 사용자를 이 주소로 redirect 시킵니다.

access token url
* {BASE_URL}/oauth/token
* access token 을 발급받는 주소입니다.
* User_email 도 같이 줍니다.
* access token 을 얻어올때 POST 를 사용합니다.

user 정보 사용하기
* 위 요청을 보내면 Hdac가치포털는 사용자 email 을 돌려줍니다. email 을 사용하여 유저를 가입시키거나 로그인 시키는데 사용합니다

상품안내 API 활용안내 (Goods-info-rest-controller)
상품등록
POST : /rest/plug/goodsinfo/add
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 goodsName 상품명 String N/A
3 hashtag hashtag String N/A
4 price 가격 String N/A
5 tokenPrice token 가격 String N/A
6 imageUrl 상품 image url String N/A
7 link_url 제휴사 url String N/A
8 useYn 사용여부 String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 goodsName 상품명 String N/A
3 hashtag hashtag String N/A
4 price 가격 String N/A
5 tokenPrice token 가격 String N/A
6 imageUrl 상품 image url String N/A
7 link_url 제휴사 url String N/A
8 useYn 사용여부 String N/A
비고(Rule)
501/599
authKey not found/save error
상품수정
POST : /rest/plug/goodsinfo/modify
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 goodsId 상품ID String N/A
3 goodsName 상품명 String N/A
4 hashtag hashtag String N/A
5 price 가격 String N/A
6 tokenPrice token 가격 String N/A
7 imageUrl 상품 image url String N/A
8 link_url 제휴사 url String N/A
9 useYn 사용여부 String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 goodsId 상품ID String N/A
3 goodsName 상품명 String N/A
4 hashtag hashtag String N/A
5 price 가격 String N/A
6 tokenPrice token 가격 String N/A
7 imageUrl 상품 image url String N/A
8 link_url 제휴사 url String N/A
9 useYn 사용여부 String N/A
비고(Rule)
501/507/599
authKey not found/wrong goodsId/save error
상품삭제
POST : /rest/plug/goodsinfo/remove
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 goodsId 상품ID String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 goodsId 상품ID String N/A
비고(Rule)
501/507/599
authKey not found/wrong goodsId/save error
상품조회
POST : /rest/plug/goodsinfo/search
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 searchHashtag 검색 hashtag String N/A
3 searchGoodsId 검색 상품ID String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 searchHashtag 검색 hashtag String N/A
3 searchGoodsId 검색 상품ID String N/A
비고(Rule)
501
authKey not found
P2P정보 API 활용안내 (p-2p-info-rest-controller)
P2P 상품등록
POST : /rest/plug/p2pInfo/add
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 p2pName P2P명 String N/A
3 hashtag hashtag String N/A
4 benefitRate 연수익률 String N/A
5 month P2P 기간 String N/A
6 redeemType 상환 종류 String N/A
7 kcb KCB 등급 String N/A
8 recuitPrice 총 모집 금액 String N/A
9 currentPrice 현재 모집 금액 String N/A
10 imageUrl 상품 image url String N/A
11 link_url 제휴사 url String N/A
12 closeYn 마감여부 String N/A
13 useYn 사용여부 String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 p2pName P2P명 String N/A
3 hashtag hashtag String N/A
4 benefitRate 연수익률 String N/A
5 month P2P 기간 String N/A
6 redeemType 상환 종류 String N/A
7 kcb KCB 등급 String N/A
8 recuitPrice 총 모집 금액 String N/A
9 currentPrice 현재 모집 금액 String N/A
10 imageUrl 상품 image url String N/A
11 link_url 제휴사 url String N/A
12 closeYn 마감여부 String N/A
13 useYn 사용여부 String N/A
비고(Rule)
501/599
authKey not found/save error
P2P 상품수정
POST : /rest/plug/p2pInfo/modify
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 p2pId P2P ID String N/A
3 p2pName P2P명 String N/A
4 hashtag hashtag String N/A
5 benefitRate 연수익률 String N/A
6 month P2P 기간 String N/A
7 redeemType 상환 종류 String N/A
8 kcb KCB 등급 String N/A
9 recuitPrice 총 모집 금액 String N/A
10 currentPrice 현재 모집 금액 String N/A
11 imageUrl 상품 image url String N/A
12 link_url 제휴사 url String N/A
13 closeYn 마감여부 String N/A
14 useYn 사용여부 String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 p2pId P2P ID String N/A
3 p2pName P2P명 String N/A
4 hashtag hashtag String N/A
5 benefitRate 연수익률 String N/A
6 month P2P 기간 String N/A
7 redeemType 상환 종류 String N/A
8 kcb KCB 등급 String N/A
9 recuitPrice 총 모집 금액 String N/A
10 currentPrice 현재 모집 금액 String N/A
11 imageUrl 상품 image url String N/A
12 link_url 제휴사 url String N/A
13 closeYn 마감여부 String N/A
14 useYn 사용여부 String N/A
비고(Rule)
501/507/599
authKey not found/wrong p2pId/save error
P2P 상품삭제
POST : /rest/plug/p2pInfo/remove
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 p2pId P2P ID String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 p2pId P2P ID String N/A
비고(Rule)
501/507/599
authKey not found/wrong p2pId/save error
P2P 상품조회
POST : /rest/plug/p2pInfo/search
NO Parameters
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 searchHashtag 검색 hashtag String N/A
3 searchP2pId 검색 P2P ID String N/A
NO Response Message
Field Field한글명 Field Type Length
1 authKey 인증키 String N/A
2 searchHashtag 검색 hashtag String N/A
3 searchP2pId 검색 P2P ID String N/A
비고(Rule)
501
authKey not found