Google Cüzdan Kart API'sı, iş ortaklarına Rotasyon Barkodlarını Google Cüzdan'a kaydetme olanağı sunar. Bu barkodlar yalnızca kısa bir süre için geçerlidir. Barkod ekran görüntüsü alma riskini azaltmak için ek güvenlik sağlar. Barkodlar, cihazda RFC 6238'e uygun şekilde oluşturulur ve iş ortağı gizli anahtarı sağlar. Ancak iş ortağı barkodları kendisi oluşturmayı tercih ederse Google, barkodların Google'a toplu olarak yüklenebileceği bir API sağlar. Daha sonra bu barkodlar kullanıcıların telefonlarına iletilir ve kısa bir süre boyunca dönüşümlü olarak gösterilen Barkodlar gibi çalışır. Bu çözüme, İş Ortağı Tarafından Oluşturulan Rotasyon Barkodları adını veriyoruz.
İş Ortağı Tarafından Oluşturulan Rotasyon Barkodu API'si
İş Ortağı Tarafından Oluşturulan Rotasyon Barkodları, aynı RotatingBarcode nesnesi kullanılarak oluşturulur. Yalnızca tür gereklidir, ancak küçük bir başlangıç kodu (yaklaşık 10 dakikalık) oluşturup initialRotatingBarcodeValues içinde göndermenizi de öneririz. İş ortağı, kullanıcı için her zaman geçerli bir barkod bulunduğundan emin olmakla sorumludur ve initialRotatingBarcodeValues, sonraki toplu yükleme çağrısının eşzamansız olmasına izin verir.
rotatingBarcode {
initialRotatingBarcodeValues: object (RotatingBarcodeValues),
type: enum (BarcodeType),
}
| Alan | Açıklama |
|---|---|
initialRotatingBarcodeValues |
Barkodda kodlanacak değerler. En az bir değer girilmelidir. Bu ilk barkodlar, kullanıcının pasaportunu ilk kez aldığı tarih ile sonraki toplu yükleme çağrısı arasındaki boşluğu doldurmayı amaçlar. |
type |
Zorunlu. Bu barkodun türü. Kabul edilebilir değerler şunlardır:
|
| Alan | Açıklama |
|---|---|
startDateTime |
İlk barkodun geçerli olduğu tarih/saat. Barkodlar Bu, bir ofset içeren ISO 8601 genişletilmiş biçim tarihi/saatidir. |
values[] |
Barkodda kodlanacak değerler. En az bir değer girilmelidir. Maksimum değer sayısı yoktur ancak istek gövdesinin boyutunun 5 MB'ı aşamayacağını unutmayın. |
periodMillis |
Her bir barkodun geçerli olduğu süre. |
Barkod değerlerini toplu olarak güncelleme
RotatingBarcode nesnesi oluşturulduktan sonra, kullanıcının geçiş süresi sona erene kadar her gün bir günlük barkodlar yüklemenizi öneririz. Bu işlem aşağıdaki REST API uç noktası ile yapılabilir.
Yöntem: transitobject.uploadrotatingbarcodevalues
Dönen barkod değerlerini, belirtilen nesne kimliğinin başvurduğu toplu taşıma nesnesine yükler.
HTTP isteği
POST
https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc
eId}/uploadRotatingBarcodeValues
Yol parametreleri
| Parametre | Açıklama |
|---|---|
resourceId |
Bir nesnenin benzersiz tanımlayıcısı. |
İstek metni
İstek metni (5 MB'ı aşamaz) RotatingBarcodeValues örneği içerir.
Yöntem: transitobject.downloadrotatingbarcodevalues
Belirtilen nesne kimliği tarafından başvurulan toplu taşıma nesnesi için dönen barkod değerlerini indirir. Bu seçenek, iş ortakları en son grubu doğrulamak isterse yararlı olur.
HTTP isteği
GET
https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do
wnloadRotatingBarcodeValues?alt=media
Yol parametreleri
| Parametre | Açıklama |
|---|---|
resourceId |
Bir nesnenin benzersiz tanımlayıcısı. |