L'API Google Wallet Passes permet aux partenaires d'enregistrer Rotation des codes-barres à Google Wallet. Ces codes-barres ne sont valides que pendant une courte période, offrant une sécurité supplémentaire pour réduire le risque de capture d'écran de codes-barres. La les codes-barres sont générés sur l'appareil conformément aux RFC 6238, où le partenaire fournissant les clé secrète. Toutefois, si un partenaire préfère générer lui-même les codes-barres, Google fournit une API permettant d'importer des codes-barres sur Google de façon groupée. Ces codes-barres être transmis aux utilisateurs comme les codes-barres rotatifs, pendant une courte période. Nous appelons cette solution "Généré par le partenaire" Codes-barres rotatifs.
API Partner-Generated Rotating Barcode
Les codes-barres rotatifs générés par les partenaires sont créés à l'aide du même
. Seul le type est requis, mais nous vous recommandons également de créer un petit déclencheur
de code-barres (une dizaine de minutes environ) et les envoyer
initialRotatingBarcodeValues Le partenaire est tenu de
s'assurer qu'il existe
toujours un code-barres valide pour l'utilisateur, et initialRotatingBarcodeValues permet
l'appel d'importation groupée suivant pour qu'il soit asynchrone.
rotatingBarcode {
initialRotatingBarcodeValues: object (RotatingBarcodeValues),
type: enum (BarcodeType),
}
| Champ | Description |
|---|---|
initialRotatingBarcodeValues |
Valeurs à encoder dans le code-barres. Veuillez indiquer au moins une valeur. Ces initiales Les codes-barres servent à combler l'écart entre le moment où l'utilisateur acquiert sa carte pour la première fois et lors de l'appel d'importation groupée suivant. |
type |
Obligatoire. Type de ce code-barres. Les valeurs acceptées sont les suivantes :
|
| Champ | Description |
|---|---|
startDateTime |
Date et heure à partir desquelles le premier code-barres est valide. La rotation des codes-barres
avec Il s'agit d'une date/heure exprimée dans le format étendu de la norme ISO 8601, avec un décalage. |
values[] |
Valeurs à encoder dans le code-barres. Veuillez indiquer au moins une valeur. Il n'y a pas de nombre maximal de valeurs, mais notez que la taille du corps de la requête ne doit pas dépasser 5 Mo. |
periodMillis |
Durée de validité de chaque code-barres. |
Mise à jour groupée des valeurs des codes-barres
Une fois l'objet RotatingBarcode créé, nous vous recommandons d'importer des fichiers d'une journée de codes-barres, tous les jours, jusqu'à l'expiration de la carte de l'utilisateur. Pour ce faire, utilisez suivant le point de terminaison de l'API REST.
Méthode: transitobject.uploadrotatingbarcodevalues
Importe les valeurs des codes-barres rotatifs dans l'objet de transports en commun référencé par l'ID d'objet donné.
Requête HTTP
POST
https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc
eId}/uploadRotatingBarcodeValues
Paramètres de chemin d'accès
| Paramètre | Description |
|---|---|
resourceId |
Identifiant unique d'un objet. |
Corps de la requête
Le corps de la requête (qui ne peut pas dépasser 5 Mo) contient une instance de RotatingBarcodeValues.
Méthode: transitobject.downloadrotatingbarcodevalues
Télécharge les valeurs des codes-barres rotatifs de l'objet de transports en commun référencé par l'objet donné. ID. Cette méthode est utile si les partenaires souhaitent vérifier le dernier lot.
Requête HTTP
GET
https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do
wnloadRotatingBarcodeValues?alt=media
Paramètres de chemin d'accès
| Paramètre | Description |
|---|---|
resourceId |
Identifiant unique d'un objet. |