Method: projects.apps.generatePlayIntegrityChallenge

Tạo ra một thử thách giúp bảo vệ tính toàn vẹn của một yêu cầu kết quả về tính toàn vẹn ngay sau khi gửi tới API Tính toàn vẹn của Play. Lệnh gọi tiếp theo tới apps.exchangePlayIntegrityToken sử dụng mã thông báo về tính toàn vẹn thu được sẽ xác minh sự hiện diện và hợp lệ của thử thách xác thực. Không nên sử dụng lại thử thách cho nhiều lệnh gọi.

Yêu cầu HTTP

POST https://firebaseappcheck.googleapis.com/v1beta/{app=projects/*/apps/*}:generatePlayIntegrityChallenge

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
app

string

Bắt buộc. Tên tài nguyên tương đối của ứng dụng, ở định dạng:

projects/{project_number}/apps/{app_id}

Nếu cần, bạn có thể thay thế phần tử project_number bằng mã dự án của dự án Firebase. Tìm hiểu thêm về cách sử dụng mã nhận dạng dự án theo tiêu chuẩn AIP 2510 của Google.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho phương thức apps.generatePlayIntegrityChallenge.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "challenge": string,
  "ttl": string
}
Trường
challenge

string

Thử thách sử dụng một lần để ứng dụng truyền đến API Tính toàn vẹn của Play.

ttl

string (Duration format)

Khoảng thời gian từ khi hình ảnh xác thực này được đúc cho đến khi hết hạn. Trường này nhằm giúp bạn dễ dàng quản lý mã thông báo phía máy khách, vì đồng hồ của máy khách có thể bị lệch, nhưng vẫn có thể đo lường chính xác khoảng thời gian.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

Để biết thêm thông tin, hãy xem bài viết Tổng quan về hoạt động xác thực.