Skip to content
Tài liệu tham khảo API
/
Điện thoại đám mây
/
/Authorization

Authorization

Các API liên quan đến Authorization.

Operations

Mã truy cập

Request

Đổi API ID và API key lấy một bearer token OAuth2.

  • Điều kiện tiên quyết: client_id là API ID và client_secret là API key. Thành viên phải đang hoạt động, và IP của bên gọi phải thỏa danh sách IP cho phép và danh sách IP chặn của Open API.
  • Tác động: không có — token được tự ký và server không lưu gì cả.
  • Thời hạn: expires_in giây, mặc định 3600. Không có refresh token và không có endpoint làm mới; hãy xin một token mới thay vì vậy.
  • Đồng thời: vì token không mang trạng thái, việc phát hành token mới không làm mất hiệu lực các token trước đó — nhiều token có thể cùng hợp lệ một lúc. Một token chỉ ngừng hoạt động khi hết hạn hoặc khi API key được luân chuyển.
  • Thử lại: an toàn.

Các mã lỗi nghiệp vụ đã ghi nhận: 12002, 35002, 35005. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Headers
Content-Typestringrequired
Example:application/json
Bodyapplication/json
client_idstringrequired

Mã định danh API xác định một thành viên.

client_secretstringrequired

Khóa API xác thực ID khách hàng. Để gọi các API của MoreLogin, bạn sẽ trao đổi ID API và Khóa API của mình để lấy mã truy cập. Hãy giữ bí mật này. an toàn.

grant_typestringrequired

Tên gói — chỉ bắt buộc nếu không cung cấp appVersionId

Example:"client_credentials"
curl -i -X POST \
  https://api.morelogin.com/oauth2/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "1661515884160372",
    "client_secret": "string",
    "grant_type": "client_credentials"
  }'

Responses

Thành công. data là một đối tượng với các trường scope, access_token, token_type, expires_in và client_metadata.

Headers
any
Bodyapplication/json
codeintegerrequired
msgstring or nullrequired
dataobjectrequired
requestIdstringrequired
Response
{
  "code": 0,
  "msg": null,
  "data": {
    "scope": "cloudphone",
    "access_token": "example-access-token\n",
    "token_type": "Bearer",
    "expires_in": 3600,
    "client_metadata": { … }
  },
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}