휴대폰번호 로그인 개발자센터

휴대폰번호 로그인 가이드

개발 가이드

상세 API목록

1. 휴대폰번호 로그인 사용자 프로필 조회 API

1.1 설명

액세스 토큰에 해당하는 휴대폰번호 로그인 사용자의 프로필을 조회합니다.
유효한 액세스 토큰(Access Token)에 대해 1회만 조회 가능합니다.
애플리케이션 등록 시 제공하기로 협의된 정보만 제공됩니다.
데이터 암호화 필요

1.2 요청 URL

URL : https://id.passlogin.com/v1/user/me

1.3 프로토콜

HTTPS

1.4 HTTP메서드

GET

1.5 요청헤더

Authorization: Bearer {access_token}

1.6 요청 파라미터

요청 파라미터는 없습니다.

요청 파라미터에 대해서 파라미터, 타입, 필수 여부, 설명으로 분류되어 제공되는 테이블
파라미터	타입	필수 여부	설명
-	-	-	-

1.7 요청 예

curl 'https://id.passlogin.com/v1/user/me'
-H 'Authorization:Bearer v+nIMm/LZZcE65H0bEdRfwmQGuGObWS8SFIxQC2ShJ1qwR2+E0MSQ/BqW3wTwvqD26i/d8gsdrNcbbvSTvcY1g=='

1.8 응답

응답에 대해서 파라미터, 타입, 필수 여부로 분류되어 제공되는 테이블
파라미터		타입	필수 여부	설명
user	plid	String	필수	휴대폰번호 로그인 사용자 식별 아이디
	ci	Encrypt(String)	옵션	PASS 사용자 식별 정보
	phoneNo	Encrypt(String)	옵션	PASS 사용자 휴대전화번호
	name	Encrypt(String)	옵션	PASS 사용자 이름
	gender	String	옵션	PASS 사용자 성별 (F:여자, M:남자)
	agegroup	String	옵션	PASS 사용자 연령대 (0, 10, 20, 30, ....) 0 : 0세~10세 미만 10 : 10세~20세 미만 20: 20세~30세 미만
	birthday	Encrypt(String)	옵션	PASS 사용자 생일 (MMDD)
	birthdate	Encrypt(String)	옵션	PASS 사용자 생년월일 (YYMMDD)
	foreign	String	옵션	PASS 사용자 내외국인정보 (L:내국인, F:외국인)

1.9 응답 예

HTTP/1.1 200 OK
{
    "code":"0000",
    "error":"success",
    "message":"성공입니다.",
    "user": {
        "plid": "de0d3c4c-a0a4-425a-981a-63ae7110dfc9",
        "ci": "7lZvMLDBN5hcv2c5IxZ4kg==",
        "phoneNo": "TEmhcQ9TBJmRPn69sWGHog==",
        "name": "0XQHxay6zdlqlxdsph9tGA==",
        "gender": "",
        "agegroup": "",
        "birthday": "7YNtESA2Uih8tlbwsNv13A==",
        "birthdate": "4s//GFT53v3aeY0ojuTLTw==",
        "foreign": "",
        "telcoCd": "L"
    }
}

1.10 복호화 가이드

복호화 방식으로는 AES 로 복호화합니다.
복호화 Key 는 개발자센터에서 부여받은 애플리케이션의 secret key 의 16자리입니다.

	/** For JAVA */
	String aesKey = "{{client_secret}}".substring(0,16);
	String algorithm = "AES/CBC/PKCS5Padding";
	IvParameterSpec iv = new IvParameterSpec(aesKey.getBytes());
	SecretKey secretKey = new SecretKeySpec(aesKey.getBytes(), "AES");
	Cipher c = Cipher.getInstance(algorithm);
	c.init(Cipher.DECRYPT_MODE, secretKey, iv);
	String name = "{{암호화된 값으로 받은 이름}}";
	String decriptName = new String(c.doFinal(Base64.getDecoder().decode(name.getBytes(charset))));

복호화 응답예

{
  "code": "0000",
  "error": "",
  "message": "성공입니다.",
  "user": {
    "plid": "de0d3c4c-a0a4-425a-981a-63ae7110dfc9",
    "ci": "abcd",
    "phoneNo": "01034520347",
    "name": "홍길동",
    "gender": "",
    "agegroup": "",
    "birthday": "0620",
    "birthdate": "800620",
    "foreign": "",
    "telcoCd": "L"
  }
}

2. 휴대폰번호 로그인 연결해제 API

2.1 설명

휴대폰번호 로그인 연결해제를 요청합니다.
휴대폰번호 로그인 플랫폼에서는 해당 제휴사의 사용자 연동정보를 해제하고, 제휴사에서는 연결해제 요청한 사용자의 휴대폰번호 로그인 식별정보를 삭제해야 합니다.

2.2 요청 URL

URL : https://id.passlogin.com/v1/user/disconnect

2.3 프로토콜

HTTPS

2.4 HTTP메서드

POST

2.5 요청헤더

Authorization: Basic {base64_encode({client_id}:{client_Secret})}
Content-Type: application/x-www-form-urlencoded

2.6 파라미터

파라미터에 대해서 파라미터, 타입, 필수 여부, 설명으로 분류되어 제공되는 테이블
파라미터	타입	필수 여부	설명
plid	String	Y	휴대폰번호 로그인 사용자 식별 아이디

2.7 요청 예

curl -X POST
'https://id.passlogin.com/v1/user/disconnect'
-H 'Authorization: Basic Y2xpZW50SWQyOm1DbGllbnRTZWNyZXQ='
-H 'Content-Type: application/x-www-form-urlencoded'
-d 'plid=084b2f3d-358e-4433-b857-1680a9ef3a5b'

2.8 응답

응답에 대해서 파라미터, 타입, 설명으로 분류되어 제공되는 테이블
파라미터	타입	설명
-	-	-

2.9 응답 예

HTTP/1.1 200 OK
{
    "code": "0000",
    "error": "success",
    "message": "성공입니다."
}

PASS로그인 SKT, KT, LG U+ 로고 아톤 로고

PASS휴대폰번호 로그인은 SK텔레콤㈜, ㈜KT, ㈜LG유플러스와 ㈜아톤이 제공하는 서비스입니다.
㈜아톤(ATON Inc.) (대표 김종서)
서울시 마포구 성암로 189 중소기업DMC타워 12층
(지하철 6호선, 공항철도 디지털미디어시티역 8번 출구와 연결)
12F KBiz DMC Tower, 189, Seongam-ro, Mapo-gu, Seoul, 03929

T 02-786-4273
F 02-786-4274
M passlogin@atoncorp.com