Interfejs API kart w Portfelu Google umożliwia partnerom zapisywanie Obracanie kodów kreskowych do Portfela Google. Takie kody kreskowe są ważne tylko przez krótki czas, dodatkowe zabezpieczenia w celu zmniejszenia ryzyka zrzutu ekranu z kodem kreskowym. Kody kreskowe są generowane na urządzeniu zgodnie z RFC 6238, w którym partner dostarcza tajny klucz. Jeśli jednak partner chce samodzielnie wygenerować kody kreskowe, Google udostępnia interfejs API umożliwiający przesyłanie zbiorcze kodów kreskowych do Google. Kody kreskowe mogą być przekazywane do w których działają jak obracające się kody kreskowe, przez krótki czas. Określamy to rozwiązanie jako wygenerowane przez partnera Obracanie kodów kreskowych.
Interfejs Rotating Barcode API wygenerowany przez partnera
Rotowane kody kreskowe wygenerowane przez partnerów są tworzone za pomocą tego samego kodu RotatingBarcode
obiektu. Wymagany jest tylko typ, ale zalecamy też utworzenie małego polecenia inicjującego
kodów kreskowych (o wartości około 10 minut) i wysyłać je
initialRotatingBarcodeValues Partner odpowiada za zapewnienie,
zawsze gotowy do użycia przez użytkownika kod kreskowy, a initialRotatingBarcodeValues zezwala
kolejne wywołanie przesyłania zbiorczego,
by było asynchroniczne.
rotatingBarcode { initialRotatingBarcodeValues: object (RotatingBarcodeValues), type: enum (BarcodeType), }
| Pole | Opis |
|---|---|
initialRotatingBarcodeValues |
Wartości do zakodowania w kodzie kreskowym. Musisz wpisać co najmniej 1 wartość. Te początkowe Kody kreskowe mają wypełnić lukę między momentem, w którym użytkownik po raz pierwszy uzyska kartę, po wykonaniu kolejnego wywołania przesyłania zbiorczego. |
type |
Wymagane. Typ tego kodu kreskowego. Akceptowane wartości:
|
| Pole | Opis |
|---|---|
startDateTime |
Data i godzina, od których pierwszy kod kreskowy jest ważny. Kody kreskowe będą poddawane rotacji
za pomocą funkcji To jest data i godzina w rozszerzonym formacie ISO 8601 z przesunięciem. |
values[] |
Wartości do zakodowania w kodzie kreskowym. Musisz wpisać co najmniej 1 wartość. Nie ma maksymalnej liczby wartości, ale pamiętaj, że rozmiar treści żądania nie może przekraczać 5 MB. |
periodMillis |
Czas ważności każdego kodu kreskowego. |
Zbiorcza aktualizacja wartości kodów kreskowych
Po utworzeniu obiektu RotatingBarcode zalecamy przesłanie dziennego kodów kreskowych każdego dnia, aż do wygaśnięcia ich ważności. Można to zrobić za pomocą z tego punktu końcowego interfejsu API REST.
Metoda: transitobject.uploadrotatingbarcodevalues
Przesyła naprzemiennie wartości kodu kreskowego do obiektu biletu na przejazd, do którego odwołuje się podany identyfikator obiektu.
Żądanie HTTP
POST
https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc
eId}/uploadRotatingBarcodeValues
Parametry ścieżki
| Parametr | Opis |
|---|---|
resourceId |
Unikalny identyfikator obiektu. |
Treść żądania
Treść żądania (która nie może przekraczać 5 MB) zawiera instancję RotatingBarcodeValues.
Metoda: transitobject.downloadrotatingbarcodevalues
Pobiera naprzemiennie wartości kodu kreskowego obiektu biletu na przejazd, do którego odwołuje się dany obiekt ID. Jest to przydatne, gdy partnerzy chcą zweryfikować najnowszy wsad.
Żądanie HTTP
GET
https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do
wnloadRotatingBarcodeValues?alt=media
Parametry ścieżki
| Parametr | Opis |
|---|---|
resourceId |
Unikalny identyfikator obiektu. |