B2COPY API은 bearer-token 인증을 사용합니다. 아래의 로그인 메소드를 호출하여 액세스/새로 고침 토큰 쌍을 얻은 다음 모든 후속 요청의 Authorization: Bearer <token> 헤더에 액세스 토큰을 포함시킵니다.
전제 조건
토큰을 얻으려면 Back Office에 이미 등록되어 있어야 하며 이에 액세스할 수 있는 자격 증명이 있어야 합니다.
엔드포인트
POST [host]/api/v2/signin요청 본문
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 문자열 | 예 | Back Office에 액세스하는 데 사용되는 이메일 주소입니다. | |
| password | 문자열 | 예 | Back Office에 액세스하는 데 사용되는 비밀번호입니다. |
curl --location --request POST 'https://host.name/api/v2/signin' \
--data-raw '{
"email": "username@example.com",
"password": "Secret123"
}'응답
응답은 각각 토큰 문자열과 createdAt / expiresAt 타임스탬프가 포함된 액세스 및 새로 고침 토큰 쌍을 반환합니다.
{
"2faRequired": false,
"accessToken": {
"token": "eyJ0eXAiOiJKV1Qi…",
"createdAt": "2024-01-01T00:00:00+00:00",
"expiresAt": "2024-01-01T00:00:00+00:00"
},
"refreshToken": {
"token": "eyJ0eXAiOiJKV1Qi…",
"createdAt": "2024-01-01T00:00:00+00:00",
"expiresAt": "2024-01-01T00:00:00+00:00"
}
}