1.공통 Headers
content-type: application/json
accept-charset: utf-8
3.회원찾기
회원 ID로 찾을때
URL: https://api.joaens.com/User_List
METHOD: POST
BODY : { "server": "DEMO", "loginID": "test"}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "1",
"User_List": [
{
"userid": "0000001",
"loginID": "test",
"username": "가(센터장,위촉)",
"recommender": "10000",
"sponsor": "",
"Invitation": "http://URL/SignUp/Index/KxkOv+xGRbQSKVjbQ04Dnw==",
"stel": "",
"mobile": "",
"e_mail": "",
"address1": "",
"address2": "",
"point1": 0.0,
"point2": 0.0,
"point3": 0.0,
"point4": 0.0,
"point5": 0.0,
"point6": 0.0,
//이하 다른 업체에서 사용중
"isActive": "0",
"Last_Order": "2023-01-01",
"Item_Type": 0,
"isActive2": "0",
"passphrase1": "",
"apikey1": "",
"secretkey1": "",
"passphrase2": "",
"apikey2": "",
"secretkey2": ""
}
]
}
4.회원가입
전체회원 목록
URL: https://api.joaens.com/SignUP
METHOD: POST
BODY : {
"server": "DEMO",
"User_type": "1", //별도 전달 사항 없다면 1번 사용
"recomm_id": "0000001", //추천인 필수 3번 회원아이디로 찾아온 값중 userid 사용
"loginID": "test4",
"User_Name": "테스트4",
"passwd": "1111",
"e_mail": "test@test.net"
}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "1",
"User_List": [
{
"userid": "0000001", //회원가입시 추천인 항목및 매출등록, 포인트 사용등에서 사용하는 회원 unique 값
"loginID": "test",
"username": "가(센터장,위촉)",
"recommender": "10000",
"sponsor": "",
"Invitation": "http://업체URL/SignUp/Index/KxkOv+xGRbQSKVjbQ04Dnw==",
"stel": "",
"mobile": "",
"e_mail": "",
"address1": "",
"address2": "",
"point1": 0.0,
"point2": 0.0,
"point3": 0.0,
"point4": 0.0,
"point5": 0.0,
"point6": 0.0,
//이하 다른 업체에서 사용중
"isActive": "0",
"Last_Order": "2023-01-01",
"Item_Type": 0,
"isActive2": "0",
"passphrase1": "",
"apikey1": "",
"secretkey1": "",
"passphrase2": "",
"apikey2": "",
"secretkey2": ""
}
]
}
5.로그인
로그인시 사용 비밀번호 입력 필요
URL: https://api.joaens.com/User
METHOD: POST
BODY :{
"server": "DEMO",
"loginID": "test4",
"passwd":"1111"
}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "정상 유저",
"userid": "0000036", //회원가입시 추천인 항목및 매출등록, 포인트 사용등에서 사용하는 회원 unique 값
"loginID": "test4",
"username": "테스트4",
"recommender": "test",
"sponsor": "",
"Invitation": "http://URL/SignUp/Index/KxkOv+xGRbRlM+qEOA+JJg==",
"stel": "",
"mobile": "",
"e_mail": "",
"address1": "",
"address2": "",
"point1": 0.0,
"point2": 0.0,
"point3": 0.0,
"point4": 0.0,
"point5": 0.0,
"point6": 0.0,

//이하 다른 업체에서 사용중
"isActive": "0",
"Last_Order": "2023-01-01",
"Item_Type": 0,
"isActive2": "0",
"passphrase1": "",
"apikey1": "",
"secretkey1": "",
"passphrase2": "",
"apikey2": "",
"secretkey2": ""
}
6.매출및 PV 등록
회원의 매출발생시 발생하는 PV값 전달
URL: https://api.joaens.com/Order
METHOD: POST
BODY :{
"server": "DEMO",
"userid": "0000001", //회원검색시 나오는 userid 값
"Tot_Amt":100, //패키지 가격
"Tot_Pv":90 //패키지에서 보너스 적용 할 금액
}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "등록완료",
"Rep_date": "20230228", //주문일자(yyyymmdd)
"Rep_time": "150609", //주문시간(HHMMSS)
"Order_no": "230228-00001" //주문일련번호
}
7.포인트 차감/증가
회원이 가지고 있는 포인트 차감 또는 증가
URL: https://api.joaens.com/Point
METHOD: POST
BODY :{
"server": "DEMO",
"userid": "0000001", //회원검색시 나오는 userid 값
"usepoint": "10", //차감또는 증가할 포인트 값
"point_kind":1, //1~ 6 범위중 사용이 지정된 포인트
"io_kind":"2" //1 = 포인트 차감 2 = 포인트 증가
}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "포인트 추가",
"Rep_date": "20230228", //발생일자(yyyymmdd)
"Rep_time": "145558", //발생시간(HHMMSS)
"userid": "0000001",
"usepoint": 15.0,
"point_kind": 1,
"restpoint": 2600.0, //발생후 현재 포인트
"loginid": null //사용안함
}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "포인트 차감",
"Rep_date": "20230228", //발생일자(yyyymmdd)
"Rep_time": "160153", //발생시간(HHMMSS)
"userid": "0000001",
"usepoint": 15.0,
"point_kind": 1,
"restpoint": 2585.0, //발생후 현재 포인트
"loginid": null //사용안함
}
8.포인트 적립/사용 내역
회원의 포인트 적립 및 사용한 내역 리스트
URL: https://api.joaens.com/MyWallet
METHOD: POST
BODY :{
"server": "DEMO",
"userid": "0000025",//회원검색시 나오는 userid 값
"date_start":"2023-03-01", //검색 시작일자
"date_end":"2023-03-10", //검색 마지막일자
"List_Count_Page":10, //1페이지에 표시할 내역수
"Current_PageNo":1, //지정 페이지
}
RESPONSE : {
"Rep_Code": "0000", //응답코드 0000 은 성공 그 외에 에러는 Rep_Desc에 설명
"Rep_Desc": "RIUM", //응답코드가 0000이 아닐경우 발생한 메세지
"Rep_date": "20230310", //API응답 일자
"Rep_time": "123902", //API응답 시간
"Data": {
"DataTotalCnt": 3, //검색기간의 총 데이터수
"DataPageCnt": 3, //현재 페이지의 총 데이터수
"lst_Wallet": [ //포인트 내역
{
"reg_date": "2023-03-09", //등록일
"pay_date": "2023-03-09", //마감일
"pay_kind": "2203", //내역 종류 5101=일마감 그외에 값은 무시
"pay_no": "0", //발생 이유 설명 은 remark에 상세 표시
"inout_kind": "1", //입출 구분 1=입금 2=출금
"issue_user": null,
"order_no": null,
"remark": "사용자등록", //포인트 발생이유
"issue_id": "",
"money1": 200.0, //발생 포인트1
"money2": 0.0, //발생 포인트2
"money3": 0.0,
"money4": 0.0,
"money5": 0.0,
"money6": 0.0,
"Table_Kind": "1"
},
{
"reg_date": "2023-03-09",
"pay_date": "2023-03-09",
"pay_kind": "2201",
"pay_no": "0",
"inout_kind": "1",
"issue_user": null,
"order_no": null,
"remark": "수당적립금",
"issue_id": "",
"money1": 150.0,
"money2": 0.0,
"money3": 0.0,
"money4": 0.0,
"money5": 0.0,
"money6": 0.0,
"Table_Kind": "1"
},
{
"reg_date": "2023-03-07",
"pay_date": "2023-03-07",
"pay_kind": "5101",
"pay_no": "1",
"inout_kind": "1",
"issue_user": null,
"order_no": null,
"remark": "추천보너스",
"issue_id": "",
"money1": 300.0,
"money2": 0.0,
"money3": 0.0,
"money4": 0.0,
"money5": 0.0,
"money6": 0.0,
"Table_Kind": "1"
}]}}
9.회원 하선 인원 목록
선택한 회원을 후원인/추천인으로 하는 회원들의 목록 표시
URL: https://api.joaens.com/MemberNetWork/MyNetWork
METHOD: POST
BODY :{
""server": "DEMO", //선택 서버
"userid": "0000001", //회원 userid
"char_kind":0, //구분 0=후원인 1=추천인
"step":3, //표시할 후원인/추천인 레벨 3은 3대까지만 표시
}
RESPONSE : {
"Rep_Code": "0000",
"Rep_Desc": "RIUM",
"Rep_date": "20230310",
"Rep_time": "124850",
"Data": {
"userid": "0000001",
"chart_kind": 0,
"Depth": 3,
"lst_Chart": [
{
"userid": "0000001", //0대 본인정보
"login_id": "k11055", //로그인아이디
"username": "8S위촉1", //회원이름
"reg_date": "2023-03-07", //회원등록일
"relationship": "00000000", //후원인 userid
"center_cd": "0000", //센터코드
"center_name": "본사", //센터
"rank_cd": "10", //등급코드
"rank_name": "8S", //등급명
"user_kind": "2101", //회원구분코드
"user_kind_name": "사업자", //구분값
"jisa_cd": "0000", //지사코드
"jisa_name": "Korea", //지사값
"pay_date": "", //마지막 매출발생일
"Tot_amt": 0.0, //총발생매출액
"Tot_Pv1": 0.0, //총발생 PV액
"children": [ //1대 하선 인원 내용은 0대와 동일
{
"userid": "0000002",
"login_id": "k64991",
"username": "8S위촉",
"reg_date": "2023-03-07",
"relationship": "0000001",
"center_cd": "0000",
"center_name": "본사",
"rank_cd": "10",
"rank_name": "8S",
"user_kind": "2101",
"user_kind_name": "사업자",
"jisa_cd": "0000",
"jisa_name": "Korea",
"pay_date": "2023-03-07",
"Tot_amt": 1000.0,
"Tot_Pv1": 1000.0,
"children": [ //2대 하선 인원
{
"userid": "0000003",
"login_id": "k06943",
"username": "7S위촉",
"reg_date": "2023-03-07",
"relationship": "0000002",
"center_cd": "0000",
"center_name": "본사",
"rank_cd": "9",
"rank_name": "7S",
"user_kind": "2101",
"user_kind_name": "사업자",
"jisa_cd": "0000",
"jisa_name": "Korea",
"pay_date": "2023-03-07",
"Tot_amt": 40000.0,
"Tot_Pv1": 40000.0,
"children": [
]
},
{
"userid": "0000004",
"login_id": "k58492",
"username": "6S위촉",
"reg_date": "2023-03-07",
"relationship": "0000002",
"center_cd": "0000",
"center_name": "본사",
"rank_cd": "8",
"rank_name": "6S",
"user_kind": "2101",
"user_kind_name": "사업자",
"jisa_cd": "0000",
"jisa_name": "Korea",
"pay_date": "2023-03-07",
"Tot_amt": 3000.0,
"Tot_Pv1": 3000.0,
"children": [
]
},
{
"userid": "0000005",
"login_id": "k30126",
"username": "5S위촉",
"reg_date": "2023-03-07",
"relationship": "0000002",
"center_cd": "0000",
"center_name": "본사",
"rank_cd": "7",
"rank_name": "5S",
"user_kind": "2101",
"user_kind_name": "사업자",
"jisa_cd": "0000",
"jisa_name": "Korea",
"pay_date": "2023-03-07",
"Tot_amt": 1000.0,
"Tot_Pv1": 1000.0,
"children": [
] }]} ]}]}}
10.자동로그인을 위한 1회용 토큰 발생
타 싸이트로그인 후 오피스로 자동로그인 하기위한 1회용 링크생성
URL: http://api.joaens.com/AutoLogin
METHOD: POST
BODY :{
"server": "DEMO",
"userid": "0000001",//회원검색시 나오는 userid 값
}
RESPONSE : {
"Rep_Code": "0000", //응답코드 0000 은 성공 그 외에 에러는 Rep_Desc에 설명
"Rep_Desc": "RIUM", //응답코드가 0000이 아닐경우 발생한 메세지
"Rep_date": "20230310", //API응답 일자
"Rep_time": "123902", //API응답 시간
"Data": {
"Reg_NO": 0, Get방식으로 넘거야할 값중 RegNo
"token": "b54adec44736d5860cd7f5c3141c4291", //Token 값
"login_link": "http://test.joaens.com/User/Gate?RegNo=0&Token=b54adec44736d5860cd7f5c3141c4291" //자동로그인을위해 사용할 링크
}}