🚀 소개
KSLINK-API 서버를 통해 여신협회 OpenAPI를 안정적이고 효율적으로 활용해보세요.
서비스 가입📘 API 문서 개요
KSLINK-API는 인증과 통신을 간편하게 처리할 수 있도록 설계되어 있습니다.
- 인증 방식: ID + API Key를 이용한 JWT 토큰(사용 서버 IP 등록 필수)
- 요청 형식: JSON 기반 POST 요청
- 응답 코드: 200(성공)
- APP 응답 코드: 2000(성공)
🧪 서비스 신청
아래 버튼을 클릭하면 팝업 창에서 본인인증 및 약관 동의 프로세스를 확인할 수 있습니다.
💡 연동 예제
<form id="popupForm" action="https://kslinkdev-api.ksnet.co.kr/join/view" method="post" target="termsPopup" style="display:none;">
<!-- 사용자ID -->
<input name="userId" type="hidden" value="ksnetuser">
<!-- 사업자명 -->
<input name="businessName" type="hidden" value="케이에스넷(주)">
<!-- 사업자번호 -->
<input name="businessNumber" type="hidden" value="123-45-67890">
<!-- 이메일 -->
<input name="businessEmail" type="hidden" value="user@example.com">
<!-- 법인 유무 (0:개인 1:법인)-->
<input name="isCorporation" type="hidden" value="0">
<!-- 대표자명 -->
<input name="representativeNameEnc" type="hidden" value="홍길동">
<!-- 생년월일 -->
<input name="representativeDobEnc" type="hidden" value="19800101">
<!-- 법인등록번호 -->
<input name="corpRegNoEnc" type="hidden" value="1111111111">
<!-- 프로그램코드 KSNET에서 발급하는 코드-->
<input name="programCode" type="hidden" value="KSL001">
<!-- WEBHOOK 사용 (0:미사용 1:사용)-->
<input name="isWebHook" type="hidden" value="0">
<!-- WEBHOOK URL -->
<input name="webhookUrl" type="hidden" value="https://localhost:9101/join/webhook">
<!-- WEBHOOK 타입 -->
<input name="webhookType" type="hidden" value="JOINAIPKEY">
</form>
<script>
function openTermsPopup() {
const width = 700;
const height = 800;
const left = (screen.width - width) / 2;
const top = (screen.height - height) / 2;
window.open('', 'termsPopup',
`width=${width},height=${height},left=${left},top=${top},scrollbars=yes`);
document.getElementById("popupForm").submit();
}
</script>
※ 실제 사용 시에는 action 경로와 파라미터를 연동 시스템에 맞게 수정해 주세요.