인증 API
앱 멤버(End User) 인증 엔드포인트입니다.
회원가입
POST /v1/public/app-members/signup
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
login_id | string | ✓ | 로그인 ID (앱 내 고유) |
password | string | ✓ | 비밀번호 |
nickname | string | ✗ | 표시명 (선택) |
bash
curl -X POST "https://api.connectbase.world/v1/public/app-members/signup" \
-H "X-Public-Key: cb_pk_your_public_key" \
-H "Content-Type: application/json" \
-d '{
"login_id": "myuser123",
"password": "password123!",
"nickname": "홍길동"
}'응답:
json
{
"member_id": "member_abc",
"nickname": "홍길동",
"access_token": "eyJhbGciOi...",
"refresh_token": "eyJhbGciOi..."
}로그인
POST /v1/public/app-members/signin
bash
curl -X POST "https://api.connectbase.world/v1/public/app-members/signin" \
-H "X-Public-Key: cb_pk_your_public_key" \
-H "Content-Type: application/json" \
-d '{
"login_id": "myuser123",
"password": "password123!"
}'응답: 회원가입과 동일한 형태(member_id, nickname, access_token, refresh_token).
게스트 멤버 가입
POST /v1/public/app-members
회원가입 없이 익명 토큰을 발급받습니다.
bash
curl -X POST "https://api.connectbase.world/v1/public/app-members" \
-H "X-Public-Key: cb_pk_your_public_key"응답:
json
{
"member_id": "guest_xxx",
"access_token": "eyJhbGciOi...",
"refresh_token": "eyJhbGciOi..."
}내 정보 조회
GET /v1/public/app-members/me
⚠️ JWT (
Authorization: Bearer) 인증 필수.
bash
curl -X GET "https://api.connectbase.world/v1/public/app-members/me" \
-H "Authorization: Bearer access_token_here"응답:
json
{
"member_id": "member_abc",
"nickname": "홍길동",
"is_active": true,
"custom_data": { "role": "admin" }
}custom_data 수정
PATCH /v1/public/app-members/me/custom-data
⚠️ JWT 인증 필수. PATCH 방식으로 머지되며, 값을
null로 설정하면 해당 키가 삭제됩니다.
bash
curl -X PATCH "https://api.connectbase.world/v1/public/app-members/me/custom-data" \
-H "Authorization: Bearer access_token_here" \
-H "Content-Type: application/json" \
-d '{
"custom_data": { "role": "admin", "level": 5 }
}'응답:
json
{
"member_id": "member_abc",
"custom_data": { "role": "admin", "level": 5 }
}로그아웃
POST /v1/auth/logout
⚠️ JWT 인증 필수. SDK 의
cb.auth.signOut()이 이 엔드포인트를 호출합니다.
bash
curl -X POST "https://api.connectbase.world/v1/auth/logout" \
-H "Authorization: Bearer access_token_here"토큰 재발급
POST /v1/auth/re-issue
refresh_token 으로 새 access_token 을 발급받습니다.
bash
curl -X POST "https://api.connectbase.world/v1/auth/re-issue" \
-H "Authorization: Bearer refresh_token_here"응답:
json
{
"access_token": "eyJhbGciOi...",
"refresh_token": "eyJhbGciOi..."
}SDK 사용 시
onTokenRefresh콜백이 자동으로 이 흐름을 처리합니다. 자세한 내용은 인증 설정 을 참고하세요.