OAuth 인가를 요청하기 전에 연동하고자 하는 서비스의 유저가 모두싸인의 회원이어야 합니다.
만약 비회원일 경우 회원가입을 유도할 수 있습니다.

🚧
다음 API는 검증된 파트너 애플리케이션에게만 제공됩니다.
관련 API 이용을 원하는 고객사는 모두싸인 고객센터로 요청해 주세요.

회원 가입 여부 확인

회원 가입

요금제 제공 요청

요금제 회수 요청

구독 갱신 요청

구독 갱신 중단 요청

회원 가입 여부 확인

회원 가입 여부 확인 API를 통해 고객의 이메일이 모두싸인에 가입되어 있는 지를 확인할 수 있습니다.
회원가입을 유도하기 전에 기존 회원 여부를 확인해 유저의 경험을 개선할 수 있습니다.

요청하기

curl --request POST \
     --url https://api.modusign.co.kr/users/verify \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
{
     "clientId": "CLIENT-ID",
     "clientSecret": "CLIENT-SECRET",
     "email": "[email protected]"
}
'

const fetch = require('node-fetch');

const url = 'https://api.modusign.co.kr/users/verify';
const options = {
  method: 'POST',
  headers: {Accept: 'application/json', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientId: 'CLIENT-ID',
    clientSecret: 'CLIENT-SECRET',
    email: '[email protected]'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('error:' + err));

응답

{
  "verified": true
}

회원 가입

회원가입 요청 API 를 통해 회원가입을 진행시킬 수 있습니다.

요청하기

회원가입 요청 시 user 항목에 가입할 유저의 이름과 이메일 주소 정보를 입력해 주세요.
추가로 고객이 회원가입을 완료한 후 이동할 페이지가 있다면 redirectUrl 항목에 주소를 추가할 수 있습니다.
redirectUrl은 프로토콜 식별자(http://, https://)를 포함한 전체 주소로 입력해주세요.

만약 회원가입 후 바로 OAuth 인가를 진행하고자 한다면, 해당 항목에 OAuth 인가 페이지 주소를 입력해주세요.
OAuth 인가에 관한 자세한 내용은 OAuth 연동하기 문서를 참고해 주세요.

curl --request POST \
     --url https://api.modusign.co.kr/users \
     --header 'Content-Type: application/json' \
     --data '
{
     "clientId": "CLIENT-ID",
     "clientSecret": "CLIENT-SECRET",
     "user": {
          "name": "김모두",
          "email": "[email protected]"
     },
     "redirectUrl": "https://app.modusign.co.kr/oauth/authorize?response_type=code&client_id=01FQE43XG5KAAA3ZKL4DFQ1S66&state=8759367&redirect_uri=https%3A%2F%2Fsite.com%2Fcallback"
}
'

const fetch = require('node-fetch');

const url = 'https://api.modusign.co.kr/users';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientId: 'CLIENT-ID',
    clientSecret: 'CLIENT-SECRET',
    user: {name: '김모두', email: '[email protected]'},
    redirectUrl: 'https%3A%2F%2Fapp.modusign.co.kr%2Foauth%2Fauthorize%3FclientId%3DCLIENT-ID%26grant_type%3Dauthorization_code%26state%3DSTATE%26redirect_uri%3Dhttp%3A%2F%2Fexample.com%3Faaa%3Dbbb'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('error:' + err));

응답

회원 가입이 정상 처리될 경우 HTTP 201 Created 응답이 돌아오며, 고객의 이메일로 "이메일 인증 메일"이 전송됩니다.
고객이 이메일을 통해 인증하기 버튼을 클릭하면, 비밀번호와 약관 동의를 하여 회원가입을 완료하는 화면으로 이동합니다.

고객이 "가입 완료" 버튼을 클릭해 모두싸인 회원가입을 완료한 뒤, 만약 요청시에 redirectUrl 항목을 입력하였다면 해당하는 Url로 이동합니다.
OAuth 인가를 위해 "OAuth 인가 페이지" URL을 입력하였다면, 바로 해당하는 "인가 요청 페이지"로 이동하여 인가로직을 진행하게 됩니다.
만약 회원가입 후 다른 화면으로 전환되길 원하는 경우 전환될 페이지 주소를 redirectUrl로 지정해 주세요.

🚧
OAuth 기능을 사용하기를 원하는 유저는 페이스북, 구글, 네이버 계정으로 모두싸인에 가입할 수 없습니다.
소셜 계정 가입이 필요한 경우 모두싸인 홈페이지를 통해 회원가입을 진행해 주세요.