B2COPY API 使用不記名令牌授權。呼叫下面的登入方法來取得存取/刷新令牌對,然後將該存取權杖包含在每個後續請求的 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"
}
}