Skip to content

API Basics and Auth

Jang Ryeol edited this page Oct 9, 2017 · 38 revisions

APIs

Authentication

헤더에 다음 정보를 추가하여야 합니다.

name description
x-access-apikey app마다 주어지는 고유한 api key입니다. 서버 관리자에게 문의 바람. /terms_of_service, /privacy_policy, /member를 제외한 api에 필수
x-access-token 로그인 시 주어지는 토큰입니다. /terms_of_service, /privacy_policy, /member, /colors, /course_books, /search_query, /tags, /app_version을 제외한 api에 필수입니다.

에러 발생 시 errcode를 반환합니다.

{
  "errcode": 8193,
  "message": "Failed to authenticate token."
}

GET terms_of_service/

이용약관

Output

HTML


GET privacy_policy/

개인정보취급방침

Output

HTML


GET member/

개발자 정보

Output

HTML


POST auth/request_temp/

임시 계정을 발급합니다.

Output

{
  "token" : "...",
  "user_id" : "..."
}

POST auth/register_local/

페이스북이 아닌 로컬 계정으로 회원가입합니다.

ID 룰은 /^[a-z0-9]{4,32}$/i, 패스워드 룰은 /^(?=.*\d)(?=.*[a-z])\S{6,20}$/i입니다.

name description example
id 유저 아이디 snutt
password 비밀번호 abc1234
email 이메일 (optional) '[email protected]'

Output

200 코드와 함께

{
  "message" : "ok",
  "token" : "...",
  "user_id" : "..."
}

POST auth/login_local/

페이스북이 아닌 로컬 계정으로 로그인합니다.
application/x-www-form-urlencoded 콘텐트 타입을 이용합니다.

name description example
id 유저 아이디 snutt
password 비밀번호 abc1234

Output

{
  "token" : "...",
  "user_id" : "..."
}

POST auth/login_fb/

페이스북 계정으로 로그인합니다. 계정이 존재하지 않는다면 새 계정을 생성합니다.

name description example
fb_id 페이스북 id
fb_token Access token

Output

{
  "token" : "...",
  "user_id" : "..."
}

POST auth/logout/

기기를 강제로 로그아웃합니다. 제 3자에 의해 토큰이 변경되었을 때, 초기화하기 위해 사용합니다.

name description example
user_id Mongo Object Id
registration_id Firebase Registration Id (Device Id)

Output

{
  "message" : "ok"
}