로그인 POST
이메일과 비밀번호로 인증하여 JWT 토큰을 발급받으세요.
엔드포인트
POST https://api.pocketalert.app/v1/auth/signin요청
헤더
| 헤더 | 필수 | 설명 |
|---|---|---|
Content-Type | ✅ | application/json |
본문 매개변수
| 매개변수 | 타입 | 필수 | 설명 |
|---|---|---|---|
email | string | ✅ | 등록된 이메일 주소 |
password | string | ✅ | 계정 비밀번호 |
요청 예시
bash
curl -X POST "https://api.pocketalert.app/v1/auth/signin" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "your-password"
}'javascript
const response = await fetch('https://api.pocketalert.app/v1/auth/signin', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: '[email protected]',
password: 'your-password'
})
});
const { token } = await response.json();
// Use token in Authorization header for subsequent requestspython
import requests
response = requests.post(
'https://api.pocketalert.app/v1/auth/signin',
json={
'email': '[email protected]',
'password': 'your-password'
}
)
data = response.json()
# Use token in Authorization header for subsequent requestsphp
$response = Http::post('https://api.pocketalert.app/v1/auth/signin', [
'email' => '[email protected]',
'password' => 'your-password',
]);
$token = $response->json()['token'];
// Use token in Authorization header for subsequent requests응답
성공 응답
200 OK
인증 성공
| 필드 | 타입 | 설명 |
|---|---|---|
token | string | API 인증에 사용하는 JWT 토큰 |
email | string | 사용자의 이메일 주소 |
name | string | 사용자의 표시 이름 |
avatar | string | 사용자 아바타 이미지의 URL |
json
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"email": "[email protected]",
"name": "John Doe",
"avatar": ""
}토큰 사용하기
토큰을 발급받은 후에는 이후 요청에 포함하세요:
bash
curl -X GET "https://api.pocketalert.app/v1/messages" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."오류 응답
| 상태 | 설명 |
|---|---|
400 | 잘못된 요청 — 이메일 또는 비밀번호가 누락되었거나 캡차 인증에 실패함 |
401 | 잘못된 인증 정보 — 비밀번호가 틀렸거나 등록되지 않은 이메일 |
권장 사항
서버 측 연동에는 JWT 토큰 대신 API 키를 사용하시길 권장합니다. API 키는 만료되지 않으며 관리하기도 더 쉽습니다.