Google Wallet Passes API memberikan kemampuan bagi partner untuk menyimpan Putar Kode batang ke Google Wallet. Kode batang ini hanya valid dalam waktu singkat, memberikan keamanan tambahan untuk mengurangi risiko tangkapan layar kode batang. Tujuan kode batang dibuat di perangkat sesuai dengan RFC 6238, dengan partner menyediakan kunci rahasia. Namun, jika mitra memilih untuk membuat sendiri kode batangnya, Google menyediakan API sehingga kode batang dapat diupload banyak ke Google. Kode batang ini kemudian akan diteruskan ke pengguna ponsel, yang akan bertindak seperti Kode Batang Berputar, ditampilkan dalam waktu singkat. Kami menyebut solusi ini sebagai Solusi Buatan Partner Kode Batang Berputar.
API Batang Berputar Buatan Partner
Kode Batang Berputar Buatan Partner dibuat menggunakan RotatingBarcode yang sama
. Hanya jenis yang diperlukan, meskipun kami juga merekomendasikan untuk membuat pemicu kecil
satu set kode batang (~10 menit), dan mengirimkannya dalam
initialRotatingBarcodeValues
. Partner bertanggung jawab untuk
memastikan bahwa ada
selalu memiliki kode batang valid yang siap bagi pengguna, dan initialRotatingBarcodeValues
memungkinkan
panggilan upload batch berikutnya menjadi asinkron.
rotatingBarcode { initialRotatingBarcodeValues: object (RotatingBarcodeValues), type: enum (BarcodeType), }
Kolom | Deskripsi |
---|---|
initialRotatingBarcodeValues |
Nilai yang akan dienkode dalam kode batang. Diperlukan setidaknya 1 nilai. Nilai awal ini kode batang dimaksudkan untuk menjembatani kesenjangan antara saat pengguna pertama kali memperoleh kartu izin lewat, dan ketika panggilan upload batch berikutnya dilakukan. |
type |
Wajib. Jenis kode batang ini. Nilai yang dapat diterima:
|
Kolom | Deskripsi |
---|---|
startDateTime |
Tanggal/waktu kode batang pertama valid. Kode batang akan dirotasikan
menggunakan Ini adalah tanggal/waktu format diperpanjang ISO 8601, dengan offset. |
values[] |
Nilai yang akan dienkode dalam kode batang. Diperlukan setidaknya 1 nilai. Tidak ada jumlah nilai maksimum, tetapi perhatikan bahwa ukuran isi permintaan tidak boleh lebih dari 5 MB. |
periodMillis |
Jumlah waktu validnya setiap kode batang. |
Memperbarui kumpulan nilai kode batang
Setelah objek RotatingBarcode dibuat, sebaiknya upload kode batang, setiap hari, hingga kartu pengguna kedaluwarsa. Hal ini dapat dilakukan dengan endpoint REST API berikut.
Metode: transitobject.uploadrotatingbarcodevalues
Mengupload nilai kode batang yang dirotasi ke objek transportasi umum yang direferensikan oleh ID objek yang diberikan.
Permintaan HTTP
POST
https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc
eId}/uploadRotatingBarcodeValues
Parameter jalur
Parameter | Deskripsi |
---|---|
resourceId |
ID unik untuk objek. |
Isi permintaan
Isi permintaan (yang tidak boleh melebihi 5 MB) berisi instance RotatingBarcodeValues.
Metode: transitobject.downloadrotatingbarcodevalues
Download nilai kode batang yang berputar untuk objek transportasi umum yang direferensikan oleh objek tertentu ke ID. Hal ini berguna jika partner ingin memverifikasi batch terbaru.
Permintaan HTTP
GET
https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do
wnloadRotatingBarcodeValues?alt=media
Parameter jalur
Parameter | Deskripsi |
---|---|
resourceId |
ID unik untuk objek. |