Project

General

Profile

Actions

New Function #1000

open

[API] #991 ISSUE 관련 API 개발 내용 전달드립니다.

Added by DongHyeok Kim 3 days ago. Updated about 17 hours ago.

Status:
Resolved
Priority:
High
Assignee:
Start date:
06/17/2025
Due date:
% Done:

0%

Estimated time:

Description

안녕하세요 부장님.

#991 이슈관련해서 API 개발된 내용 전달드립니다.
 

한번 확인해주시고 문제가 있거나 수정이 필요한 부분이 있다면 확인부탁드립니다.

이벤트 관련 API 및 화면 정리한 내용입니다.

 

이벤트 코드 접속 페이지 - 사용자의 userSeq 값을 기준으로 출력

 

테스트 페이지 

http://app.stoneitgt.com:29080/jobaba-api/event?userToken=4163613149764258534a4f4774534c77563969543267
http://app.stoneitgt.com:29080/jobaba-api/event?userToken=73737a586a4466465143794d31347733786641737951
http://app.stoneitgt.com:29080/jobaba-api/event?userToken=5f557a4158784263526d694d77463851584d5a6f6151
http://app.stoneitgt.com:29080/jobaba-api/event?userToken=49534a6e67624159514947695a344777474843424c67

 



개발 API 접속 주소
http://app.stoneitgt.com:29080/jobaba-api/swagger-ui.html

경기도 일자리 재단 공통 API
추가 된 API

-- 메인 화면 이벤트 배너 조회 ( 종료된 내역은 조회 되지 않음)
/api/getEventMainBanner

 

 

- 조회 조건 없음


결과 값 :
{
  "bannerUrl": "배너 이미지 URL",
  "title": "배너 제목",
  "cnts": "배너 내용",
  "linkUrl": "배너링크",
  "linkTargetYn": "배너 새창 여부",
  "imgTxt": "이미지 대체 텍스트",
  "endYn": "종료여부(Y:종료, N:미종료)"
}


-- 이벤트 코드 등록
/api/eventCodeSave


- 조회 조건
{
  "referralCode": "접속자 이벤트 코드",
  "userToken": "사용자 토큰"
}

- 결과 값
{
  "referralCode": "접속자 이벤트 코드",
  "referralCodeCount": "접속자 이벤트 코드 등록수",
  "message": "string",
  "errorCode": "string"
}


errorCode : -100    message : "사용자 정보가 없습니다."
errorCode : -101    message : "등록된 추천인 코드가 너무 깁니다. 최대길이(10자이하)"
errorCode : -102    message : "사용자 본인의 추천 코드입니다."
errorCode : -103    message : "존재하지 않는 추천 코드입니다."
errorCode : 200    message : "추천인 코드 등록 성공"


-- 이벤트 전체 목록 조회
/api/getEventBannerList


- 조회 조건 없음
-- 결과값
{
  "bannerUrl": "배너 이미지 URL",
  "title": "배너 제목",
  "cnts": "배너 내용",
  "linkUrl": "배너링크",
  "linkTargetYn": "배너 새창 여부",
  "imgTxt": "이미지 대체 텍스트",
  "endYn": "종료여부(Y:종료, N:미종료)"
}


-- 사용자 코드 등록 상태 확인
/api/getEventCodeStatus


--------검색조건
  "userToken": "사용자 토큰"

결과 값
{
  "referralCode": "접속자 이벤트 코드",
  "referralCodeCount": "접속자 이벤트 코드 등록 수",
  "message": "string",
  "errorCode": "string"
}


 등록 코드가 있을경우 referralCodeCount = 1 , referralCode 코드값 전송
 등록 코드가 없을경우 referralCodeCount = 0 , referralCode = null


errorCode : -100    message : "사용자 정보가 없습니다."
errorCode : 200    message : "추천인 코드 조회 성공"
 

 

감사합니다.

 

Actions #1

Updated by Deca Park 2 days ago

  • Assignee changed from Deca Park to Toby Pham
Actions #2

Updated by Toby Pham 1 day ago

  • Status changed from New to Resolved
  • Assignee changed from Toby Pham to Deca Park
Actions #3

Updated by Deca Park about 17 hours ago

  • Assignee changed from Deca Park to DongHyeok Kim
Actions

Also available in: Atom PDF