Privet est une API de découverte locale d'appareils de nuage utilisée par les services de nuage. Ce document est organisé\n dans les sections suivantes:
"},{"id":"text-2","type":"text","heading":"","plain_text":"Introduction: introduction à Privet\nDécouverte: mécanismes de découverte locaux\nAnnonces: annonces de découverte locale\nAPI: API Privet pour les périphériques cloud généraux\nAPI d'imprimante: API Privet utilisées par les imprimantes\nAnnexe: schémas supplémentaires","html":"Introduction: introduction à Privet\nDécouverte: mécanismes de découverte locaux\nAnnonces: annonces de découverte locale\nAPI: API Privet pour les périphériques cloud généraux\nAPI d'imprimante: API Privet utilisées par les imprimantes\nAnnexe: schémas supplémentaires
"},{"id":"text-3","type":"text","heading":"","plain_text":"1. Introduction\nLes appareils connectés au cloud présentent de nombreux avantages. Ils peuvent utiliser les services de conversion en ligne, le travail hôte\n file d'attente lorsque l'appareil est hors ligne et accessible de partout dans le monde. Cependant, avec\n nombreux périphériques accessibles par un utilisateur donné dans le cloud, nous devons fournir une méthode permettant de\n appareil le plus proche en fonction de l'emplacement. Le protocole Privet a pour objectif de lier la flexibilité des\n périphériques cloud avec un mécanisme de découverte local approprié, de sorte que les périphériques soient facilement découverts\n nouveaux environnements.\nLes objectifs de ce protocole sont:","html":"1. Introduction\nLes appareils connectés au cloud présentent de nombreux avantages. Ils peuvent utiliser les services de conversion en ligne, le travail hôte\n file d'attente lorsque l'appareil est hors ligne et accessible de partout dans le monde. Cependant, avec\n nombreux périphériques accessibles par un utilisateur donné dans le cloud, nous devons fournir une méthode permettant de\n appareil le plus proche en fonction de l'emplacement. Le protocole Privet a pour objectif de lier la flexibilité des\n périphériques cloud avec un mécanisme de découverte local approprié, de sorte que les périphériques soient facilement découverts\n nouveaux environnements.\nLes objectifs de ce protocole sont:
"},{"id":"text-4","type":"text","heading":"","plain_text":"rendre les périphériques cloud détectables localement\nenregistrer des périphériques cloud avec un service cloud\nassocier les appareils enregistrés à leur représentation dans le nuage\nactiver la fonctionnalité hors ligne\nsimplifier la mise en œuvre pour que les petits appareils puissent l'utiliser","html":"rendre les périphériques cloud détectables localement\nenregistrer des périphériques cloud avec un service cloud\nassocier les appareils enregistrés à leur représentation dans le nuage\nactiver la fonctionnalité hors ligne\nsimplifier la mise en œuvre pour que les petits appareils puissent l'utiliser
"},{"id":"text-5","type":"text","heading":"","plain_text":"Le protocole Privet comprend 2 parties principales: découverte et API. La découverte est utilisée pour trouver le\n périphérique sur le réseau local, et l’API permet d’obtenir des informations sur le périphérique et\n effectuer des actions. Tout au long de ce document, l'appareil désigne un appareil connecté au cloud\n implémenter le protocole Privet.\n2. découverte\nDiscovery est un protocole basé sur zeroconf (mDNS + DNS-SD). Le périphérique DOIT implémenter IPv4 Link-Local\n Adresser. L'appareil DOIT être conforme aux spécifications mDNS et DNS-SD.\nLe dispositif DOIT effectuer la résolution des conflits de noms conformément aux spécifications ci-dessus.\n2.1. type de service\nLa découverte de service DNS utilise le format suivant pour les types de service:\n _applicationprotocol._transportprotocol. Dans le cas du protocole Privet, le service\n type pour DNS-SD devrait être: _privet._tcp\nL'appareil peut également implémenter d'autres types de services. Il est conseillé d'utiliser le même service\n nom d'instance pour tous les types de services implémentés par le périphérique. Par exemple: une imprimante peut\n implémentez les services "Imprimante XYZ._privet._tcp" et "Imprimante XYZ._printer._tcp". Ça va simplifier\n configuration pour l'utilisateur. Cependant, les clients Privet rechercheront uniquement "_privet._tcp".\nEn plus du type de service principal, l’appareil DOIT annoncer les enregistrements PTR pour ses\n sous-type (s) correspondant (voir spéc. DNS-SD: "7.1. Énumération d'instances sélective (sous-types)").\n Le format devrait être le suivant:\n _._sub.privet._tcp\nActuellement, le seul sous-type de périphérique pris en charge est imprimante. Donc, toutes les imprimantes DOIVENT annoncer\n deux enregistrements PTR:","html":"Le protocole Privet comprend 2 parties principales: découverte et API. La découverte est utilisée pour trouver le\n périphérique sur le réseau local, et l’API permet d’obtenir des informations sur le périphérique et\n effectuer des actions. Tout au long de ce document, l'appareil désigne un appareil connecté au cloud\n implémenter le protocole Privet.\n2. découverte\nDiscovery est un protocole basé sur zeroconf (mDNS + DNS-SD). Le périphérique DOIT implémenter IPv4 Link-Local\n Adresser. L'appareil DOIT être conforme aux spécifications mDNS et DNS-SD.\nLe dispositif DOIT effectuer la résolution des conflits de noms conformément aux spécifications ci-dessus.\n2.1. type de service\nLa découverte de service DNS utilise le format suivant pour les types de service:\n _applicationprotocol._transportprotocol. Dans le cas du protocole Privet, le service\n type pour DNS-SD devrait être: _privet._tcp\nL'appareil peut également implémenter d'autres types de services. Il est conseillé d'utiliser le même service\n nom d'instance pour tous les types de services implémentés par le périphérique. Par exemple: une imprimante peut\n implémentez les services "Imprimante XYZ._privet._tcp" et "Imprimante XYZ._printer._tcp". Ça va simplifier\n configuration pour l'utilisateur. Cependant, les clients Privet rechercheront uniquement "_privet._tcp".\nEn plus du type de service principal, l’appareil DOIT annoncer les enregistrements PTR pour ses\n sous-type (s) correspondant (voir spéc. DNS-SD: "7.1. Énumération d'instances sélective (sous-types)").\n Le format devrait être le suivant:\n _._sub.privet._tcp\nActuellement, le seul sous-type de périphérique pris en charge est imprimante. Donc, toutes les imprimantes DOIVENT annoncer\n deux enregistrements PTR:
"},{"id":"text-6","type":"text","heading":"","plain_text":"_privet._tcp.local.\n_printer._sub._privet._tcp.local.","html":"_privet._tcp.local.\n_printer._sub._privet._tcp.local.
"},{"id":"text-7","type":"text","heading":"","plain_text":"2.2. Enregistrement TXT\nle Découverte du service DNS définit des champs pour ajouter des informations facultatives sur un service dans\n les enregistrements TXT. Un enregistrement TXT est constitué de paires clé / valeur. Chaque paire clé / valeur commence à partir du\n longueur octet suivi de 255 octets de texte au maximum. La clé est le texte avant le premier\n Le caractère "=" et la valeur correspond au texte après le premier caractère "="\n jusqu'à la fin. La spécification ne permet aucune valeur dans l'enregistrement, dans ce cas, il n'y aura aucune\n Caractère "=" OU pas de texte après le caractère "=". (Voir spéc. DNS-SD:\n "6.1. Règles générales de format pour les enregistrements DNS TXT" pour le format d'enregistrement DNS TXT et "6.2. DNS-SD TXT\n Taille d'enregistrement "pour la longueur recommandée).\nPrivet exige que le périphérique envoie les paires clé / valeur suivantes dans l'enregistrement TXT. Valeur clé\n les chaînes ne respectent pas la casse, par exemple "CS = online" et "cs = ONLINE" sont\n le même. Les informations contenues dans l'enregistrement TXT DOIVENT être identiques à celles accessibles via l'API / info (voir 4.1.\n Section API).\nIl est recommandé de conserver une taille d’enregistrement TXT inférieure à 512 octets.\n2.2.1. txtvers\nVersion de la structure TXT. txtvers DOIT être le premier enregistrement de la structure TXT. Actuellement\n la seule version supportée est 1.\ntxtvers = 1\n2.2.2. ty\nFournit un nom lisible par l'utilisateur du périphérique. Par exemple:\nty = Modèle d'imprimante Google Cloud Ready XYZ\n2.2.3. note (optionnel)\nFournit un nom lisible par l'utilisateur du périphérique. Par exemple:\nnote = Imprimeur de lobby au 1er étage\nRemarque: Ceci est une clé optionnelle et peut être ignorée. Cependant, si présent, l'utilisateur\n DEVRAIT pouvoir modifier cette valeur. La même description DOIT être utilisée lors de l'enregistrement d'un appareil.\n2.2.4. url\nURL du serveur auquel cet appareil est connecté (protocole compris). Par exemple:\nurl = https: //www.google.com/cloudprint\n2.2.5. type\nListe de sous-types de périphérique pris en charge par ce périphérique, séparés par des virgules. Le format est:\n "type = _subtype1, _subtype2". Actuellement, le seul sous-type de périphérique pris en charge est\n imprimante.\ntype = imprimante\nChaque sous-type répertorié doit être annoncé à l'aide d'un enregistrement PTR correspondant. Pour chaque supporté\n service, il doit y avoir un élément correspondant. Nom du sous-type de service\n (._sub.privet._tcp) devrait être égal au type de périphérique ici.\n2.2.6. identifiant\nReference de l'appareil. Si le périphérique n'a pas encore été enregistré, cette clé doit être présente, mais la valeur\n devrait être vide. Par exemple:","html":"2.2. Enregistrement TXT\nle Découverte du service DNS définit des champs pour ajouter des informations facultatives sur un service dans\n les enregistrements TXT. Un enregistrement TXT est constitué de paires clé / valeur. Chaque paire clé / valeur commence à partir du\n longueur octet suivi de 255 octets de texte au maximum. La clé est le texte avant le premier\n Le caractère "=" et la valeur correspond au texte après le premier caractère "="\n jusqu'à la fin. La spécification ne permet aucune valeur dans l'enregistrement, dans ce cas, il n'y aura aucune\n Caractère "=" OU pas de texte après le caractère "=". (Voir spéc. DNS-SD:\n "6.1. Règles générales de format pour les enregistrements DNS TXT" pour le format d'enregistrement DNS TXT et "6.2. DNS-SD TXT\n Taille d'enregistrement "pour la longueur recommandée).\nPrivet exige que le périphérique envoie les paires clé / valeur suivantes dans l'enregistrement TXT. Valeur clé\n les chaînes ne respectent pas la casse, par exemple "CS = online" et "cs = ONLINE" sont\n le même. Les informations contenues dans l'enregistrement TXT DOIVENT être identiques à celles accessibles via l'API / info (voir 4.1.\n Section API).\nIl est recommandé de conserver une taille d’enregistrement TXT inférieure à 512 octets.\n2.2.1. txtvers\nVersion de la structure TXT. txtvers DOIT être le premier enregistrement de la structure TXT. Actuellement\n la seule version supportée est 1.\ntxtvers = 1\n2.2.2. ty\nFournit un nom lisible par l'utilisateur du périphérique. Par exemple:\nty = Modèle d'imprimante Google Cloud Ready XYZ\n2.2.3. note (optionnel)\nFournit un nom lisible par l'utilisateur du périphérique. Par exemple:\nnote = Imprimeur de lobby au 1er étage\nRemarque: Ceci est une clé optionnelle et peut être ignorée. Cependant, si présent, l'utilisateur\n DEVRAIT pouvoir modifier cette valeur. La même description DOIT être utilisée lors de l'enregistrement d'un appareil.\n2.2.4. url\nURL du serveur auquel cet appareil est connecté (protocole compris). Par exemple:\nurl = https: //www.google.com/cloudprint\n2.2.5. type\nListe de sous-types de périphérique pris en charge par ce périphérique, séparés par des virgules. Le format est:\n "type = _subtype1, _subtype2". Actuellement, le seul sous-type de périphérique pris en charge est\n imprimante.\ntype = imprimante\nChaque sous-type répertorié doit être annoncé à l'aide d'un enregistrement PTR correspondant. Pour chaque supporté\n service, il doit y avoir un élément correspondant. Nom du sous-type de service\n (._sub.privet._tcp) devrait être égal au type de périphérique ici.\n2.2.6. identifiant\nReference de l'appareil. Si le périphérique n'a pas encore été enregistré, cette clé doit être présente, mais la valeur\n devrait être vide. Par exemple:
"},{"id":"text-8","type":"text","heading":"","plain_text":"id = 11111111-2222-3333-4444-555555555555\n id =","html":"id = 11111111-2222-3333-4444-555555555555\n id =
"},{"id":"text-9","type":"text","heading":"","plain_text":"2.2.7. cs\nIndique l’état actuel de la connexion du périphérique. Quatre valeurs possibles sont définies dans cette\n spec.","html":"2.2.7. cs\nIndique l’état actuel de la connexion du périphérique. Quatre valeurs possibles sont définies dans cette\n spec.
"},{"id":"text-10","type":"text","heading":"","plain_text":""online" indique que l'appareil est actuellement connecté au cloud.\n"hors ligne" indique que le périphérique est disponible sur le réseau local, mais\n ne peux pas parler au serveur.\n"connexion" indique que le périphérique effectue sa séquence de démarrage et est en train de\n pas encore complètement en ligne.\n"non configuré" indique que l'accès Internet de l'appareil n'a pas été\n configuré pour le moment. Cette valeur n’est pas utilisée actuellement, mais peut être utile dans les futures versions du logiciel.\n spécification.","html":""online" indique que l'appareil est actuellement connecté au cloud.\n"hors ligne" indique que le périphérique est disponible sur le réseau local, mais\n ne peux pas parler au serveur.\n"connexion" indique que le périphérique effectue sa séquence de démarrage et est en train de\n pas encore complètement en ligne.\n"non configuré" indique que l'accès Internet de l'appareil n'a pas été\n configuré pour le moment. Cette valeur n’est pas utilisée actuellement, mais peut être utile dans les futures versions du logiciel.\n spécification.
"},{"id":"text-11","type":"text","heading":"","plain_text":"Par exemple:","html":"Par exemple:
"},{"id":"text-12","type":"text","heading":"","plain_text":"cs = en ligne\ncs = hors ligne\ncs = connexion","html":"cs = en ligne\ncs = hors ligne\ncs = connexion
"},{"id":"text-13","type":"text","heading":"","plain_text":"Si le périphérique a été enregistré dans un nuage, il doit vérifier au démarrage la connectivité avec\n serveur pour détecter son état de connexion (par exemple, appeler une API cloud pour obtenir les paramètres du périphérique). le\n L’équipement peut utiliser l’état de la connexion de son canal de notification (XMPP, par exemple) pour signaler cette valeur.\n Les périphériques non enregistrés au démarrage peuvent envoyer un ping à un domaine afin de détecter leur état de connexion (par exemple,\n exemple, effectuez un ping sur www.google.com pour les périphériques d’impression dans le cloud\n3. Annonces\nAu démarrage, à l'arrêt ou au changement d'état du périphérique, le périphérique DOIT exécuter l'étape de l'annonce\n décrit dans la spécification mDNS. Il\n DEVRAIT envoyer l'annonce correspondante au moins deux fois avec un intervalle d'au moins une seconde\n entre eux.\n3.1. Commencez\nAu démarrage de l'appareil, il DOIT exécuter les étapes de vérification et d'annonce décrites dans le manuel mDNS.\n spécification. Les enregistrements SRV, PTR et TXT doivent être envoyés dans ce cas. Il est recommandé de grouper\n tous les enregistrements dans une réponse DNS si possible. Si non, l'ordre suivant est recommandé: SRV,\n PTR, enregistrements TXT.\n3.2. Fermer\nLors de l’arrêt de l’appareil, il DEVRAIT essayer d’en informer toutes les parties intéressées en envoyant un message.\n "Au revoir paquet" avec TTL = 0 (comme décrit dans la documentation de mDNS).\n3.3. Mise à jour\nSi l’une des informations décrites dans TXT a changé, le périphérique DOIT envoyer une mise à jour.\n annonce. Dans ce cas, il suffit d’envoyer le nouvel enregistrement TXT. Par exemple, après un\n appareil est enregistré, il DOIT envoyer une annonce de mise à jour incluant le nouvel identifiant d'appareil.\n4. API\nUne fois qu'un périphérique cloud a été découvert, la communication client est activée avec le périphérique.\n directement sur le réseau local. Toutes les API sont basées sur HTTP 1.1. Les formats de données sont basés sur JSON. API\n les requêtes peuvent être des requêtes GET ou POST.\nChaque demande DOIT contenir un "X-Privet-Token"en-tête. La SEULE demande\n autorisé à avoir un en-tête "X-Privet-Token" vide est la requête / privet / info (note\n l'en-tête DOIT toujours être présent). Si l'en-tête "X-Privet-Token" est manquant, le\n le périphérique DOIT répondre avec l'erreur HTTP 400 suivante:\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\nSi l'en-tête "X-Privet-Token" est vide ou invalide, le périphérique DOIT répondre avec\n "erreur X-Privet-Token non valide" (invalid_x_privet_token, voir la section Erreurs pour plus de détails).\n détails). La seule exception est l'API / info. Pour voir plus d'informations sur pourquoi cela est fait et comment les jetons\n voir Annexe A: Attaques XSSI et XSRF et prévention.\nSi une API demandée n'existe pas ou n'est pas prise en charge, le périphérique DOIT renvoyer une erreur HTTP 404.\n4.1. Disponibilité de l'API\nAvant TOUTE API ne soit exposée (y compris l’API / info), le périphérique DOIT contacter le serveur pour vérifier\n paramètres locaux. Les paramètres locaux DOIVENT être préservés entre\n redémarre. Si le serveur n'est pas disponible, les derniers paramètres locaux connus doivent être utilisés. Si la\n L'appareil n'a pas encore été enregistré, il devrait suivre les paramètres par défaut.\nLes périphériques Cloud Print DOIVENT suivre les étapes ci-dessous pour enregistrer, recevoir et mettre à jour les paramètres locaux.\n4.1.1. enregistrement\nLorsque le périphérique s'inscrit, il DOIT spécifier le paramètre "local_settings", comme suit:","html":"Si le périphérique a été enregistré dans un nuage, il doit vérifier au démarrage la connectivité avec\n serveur pour détecter son état de connexion (par exemple, appeler une API cloud pour obtenir les paramètres du périphérique). le\n L’équipement peut utiliser l’état de la connexion de son canal de notification (XMPP, par exemple) pour signaler cette valeur.\n Les périphériques non enregistrés au démarrage peuvent envoyer un ping à un domaine afin de détecter leur état de connexion (par exemple,\n exemple, effectuez un ping sur www.google.com pour les périphériques d’impression dans le cloud\n3. Annonces\nAu démarrage, à l'arrêt ou au changement d'état du périphérique, le périphérique DOIT exécuter l'étape de l'annonce\n décrit dans la spécification mDNS. Il\n DEVRAIT envoyer l'annonce correspondante au moins deux fois avec un intervalle d'au moins une seconde\n entre eux.\n3.1. Commencez\nAu démarrage de l'appareil, il DOIT exécuter les étapes de vérification et d'annonce décrites dans le manuel mDNS.\n spécification. Les enregistrements SRV, PTR et TXT doivent être envoyés dans ce cas. Il est recommandé de grouper\n tous les enregistrements dans une réponse DNS si possible. Si non, l'ordre suivant est recommandé: SRV,\n PTR, enregistrements TXT.\n3.2. Fermer\nLors de l’arrêt de l’appareil, il DEVRAIT essayer d’en informer toutes les parties intéressées en envoyant un message.\n "Au revoir paquet" avec TTL = 0 (comme décrit dans la documentation de mDNS).\n3.3. Mise à jour\nSi l’une des informations décrites dans TXT a changé, le périphérique DOIT envoyer une mise à jour.\n annonce. Dans ce cas, il suffit d’envoyer le nouvel enregistrement TXT. Par exemple, après un\n appareil est enregistré, il DOIT envoyer une annonce de mise à jour incluant le nouvel identifiant d'appareil.\n4. API\nUne fois qu'un périphérique cloud a été découvert, la communication client est activée avec le périphérique.\n directement sur le réseau local. Toutes les API sont basées sur HTTP 1.1. Les formats de données sont basés sur JSON. API\n les requêtes peuvent être des requêtes GET ou POST.\nChaque demande DOIT contenir un "X-Privet-Token"en-tête. La SEULE demande\n autorisé à avoir un en-tête "X-Privet-Token" vide est la requête / privet / info (note\n l'en-tête DOIT toujours être présent). Si l'en-tête "X-Privet-Token" est manquant, le\n le périphérique DOIT répondre avec l'erreur HTTP 400 suivante:\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\nSi l'en-tête "X-Privet-Token" est vide ou invalide, le périphérique DOIT répondre avec\n "erreur X-Privet-Token non valide" (invalid_x_privet_token, voir la section Erreurs pour plus de détails).\n détails). La seule exception est l'API / info. Pour voir plus d'informations sur pourquoi cela est fait et comment les jetons\n voir Annexe A: Attaques XSSI et XSRF et prévention.\nSi une API demandée n'existe pas ou n'est pas prise en charge, le périphérique DOIT renvoyer une erreur HTTP 404.\n4.1. Disponibilité de l'API\nAvant TOUTE API ne soit exposée (y compris l’API / info), le périphérique DOIT contacter le serveur pour vérifier\n paramètres locaux. Les paramètres locaux DOIVENT être préservés entre\n redémarre. Si le serveur n'est pas disponible, les derniers paramètres locaux connus doivent être utilisés. Si la\n L'appareil n'a pas encore été enregistré, il devrait suivre les paramètres par défaut.\nLes périphériques Cloud Print DOIVENT suivre les étapes ci-dessous pour enregistrer, recevoir et mettre à jour les paramètres locaux.\n4.1.1. enregistrement\nLorsque le périphérique s'inscrit, il DOIT spécifier le paramètre "local_settings", comme suit:
"},{"id":"text-14","type":"text","heading":"","plain_text":" "actuel": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": true,\n "printer / conversion_printing_enabled": true,\n "xmpp_timeout_value": 300\n ","html":""actuel": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": true,\n "printer / conversion_printing_enabled": true,\n "xmpp_timeout_value": 300\n
"},{"id":"text-15","type":"text","heading":"","plain_text":"Les paramètres suivants peuvent être définis:","html":"Les paramètres suivants peuvent être définis:
"},{"id":"text-16","type":"text","heading":"","plain_text":"Nom de la valeur\nType de valeur\nLa description","html":"Nom de la valeur\nType de valeur\nLa description
"},{"id":"text-17","type":"text","heading":"","plain_text":"découverte_locale\nbooléen\nIndique si la fonctionnalité de découverte locale est\n permis. Si "false", toutes les découvertes d'API locale (y compris / info) et DNS-SD doivent être désactivées. Par\n Par défaut, les périphériques nouvellement enregistrés doivent passer "true".","html":"découverte_locale\nbooléen\nIndique si la fonctionnalité de découverte locale est\n permis. Si "false", toutes les découvertes d'API locale (y compris / info) et DNS-SD doivent être désactivées. Par\n Par défaut, les périphériques nouvellement enregistrés doivent passer "true".
"},{"id":"text-18","type":"text","heading":"","plain_text":"access_token_enabled\nbooléen (optionnel)\nIndique si / accesstoken API\n devrait être exposé sur le réseau local. Par défaut devrait être "true".","html":"access_token_enabled\nbooléen (optionnel)\nIndique si / accesstoken API\n devrait être exposé sur le réseau local. Par défaut devrait être "true".
"},{"id":"text-19","type":"text","heading":"","plain_text":"printer / local_printing_enabled\nbooléen (optionnel)\nIndique si local\n la fonctionnalité d’impression (/ printer / createjob, / printer / submitdoc, / printer / jobstate) devrait être\n exposés sur le réseau local. Par défaut devrait être "true".","html":"printer / local_printing_enabled\nbooléen (optionnel)\nIndique si local\n la fonctionnalité d’impression (/ printer / createjob, / printer / submitdoc, / printer / jobstate) devrait être\n exposés sur le réseau local. Par défaut devrait être "true".
"},{"id":"text-20","type":"text","heading":"","plain_text":"printer / conversion_printing_enabled\nbooléen (optionnel)\nIndique si local\n l'impression peut envoyer le travail au serveur pour la conversion. Cela n’a de sens que lorsque l’impression locale est activée.","html":"printer / conversion_printing_enabled\nbooléen (optionnel)\nIndique si local\n l'impression peut envoyer le travail au serveur pour la conversion. Cela n’a de sens que lorsque l’impression locale est activée.
"},{"id":"text-21","type":"text","heading":"","plain_text":"xmpp_timeout_value\nint (facultatif)\nIndique le nombre de secondes entre\n Pingles de canal XMPP. Par défaut, DOIT être 300 (5 minutes) ou plus.","html":"xmpp_timeout_value\nint (facultatif)\nIndique le nombre de secondes entre\n Pingles de canal XMPP. Par défaut, DOIT être 300 (5 minutes) ou plus.
"},{"id":"text-22","type":"text","heading":"","plain_text":"Important: L’absence de valeur optionnelle indique que le\n la fonctionnalité correspondante est complètement non prise en charge par le périphérique.\n4.1.2. Commencez\nAu démarrage du périphérique, le serveur doit contacter le serveur pour vérifier quelles API sont disponibles pour être exposées dans\n le réseau local. Pour les imprimantes connectées à Cloud Print, elles doivent appeler:\n/ cloudprint / printer? printerid =\nou\n/ cloudprint / list\n/ cloudprint / printer est préférable à / cloudprint / list, mais les deux fonctionneront.\nCette API renvoie les paramètres actuels du périphérique, y compris les paramètres de l'API locale. La réponse du\n Le serveur aura le format suivant:","html":"Important: L’absence de valeur optionnelle indique que le\n la fonctionnalité correspondante est complètement non prise en charge par le périphérique.\n4.1.2. Commencez\nAu démarrage du périphérique, le serveur doit contacter le serveur pour vérifier quelles API sont disponibles pour être exposées dans\n le réseau local. Pour les imprimantes connectées à Cloud Print, elles doivent appeler:\n/ cloudprint / printer? printerid =\nou\n/ cloudprint / list\n/ cloudprint / printer est préférable à / cloudprint / list, mais les deux fonctionneront.\nCette API renvoie les paramètres actuels du périphérique, y compris les paramètres de l'API locale. La réponse du\n Le serveur aura le format suivant:
"},{"id":"text-23","type":"text","heading":"","plain_text":""paramètres locaux": \n "actuel": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": true,\n "printer / conversion_printing_enabled": true,\n "xmpp_timeout_value": 300\n ,\n "en attente": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": false,\n "printer / conversion_printing_enabled": false,\n "xmpp_timeout_value": 500\n ","html":""paramètres locaux": \n "actuel": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": true,\n "printer / conversion_printing_enabled": true,\n "xmpp_timeout_value": 300\n ,\n "en attente": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": false,\n "printer / conversion_printing_enabled": false,\n "xmpp_timeout_value": 500\n
"},{"id":"text-24","type":"text","heading":"","plain_text":"L'objet "en cours" indique les paramètres en vigueur pour le moment.\nL'objet "en attente" indique les paramètres à appliquer au périphérique (cet objet\n peut être manquant).\nUne fois que le périphérique voit les paramètres "en attente", il DOIT mettre à jour son état (voir ci-dessous).\n4.1.3. Mise à jour\nSi une mise à jour des paramètres est nécessaire, une notification XMPP sera envoyée au périphérique. La notification\n sera dans le format suivant:\n/mettre à jour les paramètres\nÀ la réception d'une telle notification, le périphérique DOIT interroger le serveur pour obtenir les derniers paramètres.\n Les périphériques Cloud Print DOIVENT utiliser:\n/ cloudprint / printer? printerid =\nUne fois que le périphérique voit la section "en attente" suite à l’API / cloudprint / printer (à\n démarrage ou en raison de la notification), il DOIT mettre à jour son état interne pour se souvenir du nouveau\n paramètres. Il DOIT appeler l'API du serveur pour confirmer les nouveaux paramètres. Pour les imprimantes en nuage, le périphérique\n DOIT appeler / cloudprint / update API et utiliser le paramètre "local_settings" comme pendant\n enregistrement.\nLors de la reconnexion au canal XMPP, le périphérique DOIT appeler / cloudprint / API pour vérifier si\n les paramètres locaux ont été modifiés depuis la dernière fois.\n4.1.3.1. Paramètres locaux en attente\nLe paramètre "local_settings" utilisé par le périphérique pour appeler l'API du serveur NE DOIT JAMAIS contenir\n section "en attente".\n4.1.3.2. Paramètres locaux actuels\nUNIQUEMENT l’appareil peut changer la section "actuelle" des "paramètres locaux".\n Tout le monde changera la section "en attente" et attendra que les modifications soient apportées.\n propagé à la section "en cours" par le périphérique.\n4.1.4. Hors ligne\nLorsqu'il est impossible de contacter le serveur au démarrage, après notification, le périphérique DOIT utiliser le dernier\n paramètres locaux.\n4.1.5. Suppression de l'appareil du service\nSi le périphérique a été supprimé du service (GCP par exemple), une notification XMPP sera envoyée.\n envoyé à l'appareil. La notification sera au format suivant:\n/effacer\nÀ la réception d'une telle notification, le périphérique DOIT se rendre sur le serveur pour vérifier son état. Nuage\n Les périphériques d’impression DOIVENT utiliser:\n/ cloudprint / printer? printerid =\nLe périphérique DOIT recevoir une réponse HTTP réussie avec success = false et aucun périphérique / imprimante.\n la description. Cela signifie que le périphérique a été retiré du serveur et que le périphérique DOIT effacer ses\n informations d’authentification et passer en mode de paramètres d’usine par défaut.\nTOUTE heure à laquelle le périphérique reçoit une réponse indiquant qu'il a été supprimé à la suite de la\n / cloudprint / API (démarrage, notification des paramètres de mise à jour, ping quotidien), elle DOIT supprimer ses\n informations d'identification et aller en mode par défaut.\n4.2. API / privet / info\nL'info API est OBLIGATOIRE et DOIT être implémentée par tous les appareils. C'est une requête HTTP GET pour\n "/ privet / info" url: GET / privet / info HTTP / 1.1\nL'API info renvoie des informations de base sur un périphérique et les fonctionnalités qu'il prend en charge. Cette API\n NE DOIT jamais changer l’état du dispositif ni effectuer aucune action, car il est vulnérable aux attaques XSRF.\n C'est la SEULE API autorisée à avoir un en-tête "X-Privet-Token" vide. Les clients devraient\n API call / privet / info avec en-tête "X-Privet-Token" définie sur X-Privet-Token:\n ""\nL'API info DOIT renvoyer des données cohérentes avec les données disponibles dans l'enregistrement TXT lors de la découverte.\n4.2.1. Contribution\n/ privet / info L'API n'a pas de paramètre d'entrée.\n4.2.2. Revenir\nL'API / privet / info renvoie des informations de base sur le périphérique et les fonctionnalités prises en charge.\nLa colonne TXT indique le champ correspondant dans l’enregistrement DNS-SD TXT.","html":"L'objet "en cours" indique les paramètres en vigueur pour le moment.\nL'objet "en attente" indique les paramètres à appliquer au périphérique (cet objet\n peut être manquant).\nUne fois que le périphérique voit les paramètres "en attente", il DOIT mettre à jour son état (voir ci-dessous).\n4.1.3. Mise à jour\nSi une mise à jour des paramètres est nécessaire, une notification XMPP sera envoyée au périphérique. La notification\n sera dans le format suivant:\n/mettre à jour les paramètres\nÀ la réception d'une telle notification, le périphérique DOIT interroger le serveur pour obtenir les derniers paramètres.\n Les périphériques Cloud Print DOIVENT utiliser:\n/ cloudprint / printer? printerid =\nUne fois que le périphérique voit la section "en attente" suite à l’API / cloudprint / printer (à\n démarrage ou en raison de la notification), il DOIT mettre à jour son état interne pour se souvenir du nouveau\n paramètres. Il DOIT appeler l'API du serveur pour confirmer les nouveaux paramètres. Pour les imprimantes en nuage, le périphérique\n DOIT appeler / cloudprint / update API et utiliser le paramètre "local_settings" comme pendant\n enregistrement.\nLors de la reconnexion au canal XMPP, le périphérique DOIT appeler / cloudprint / API pour vérifier si\n les paramètres locaux ont été modifiés depuis la dernière fois.\n4.1.3.1. Paramètres locaux en attente\nLe paramètre "local_settings" utilisé par le périphérique pour appeler l'API du serveur NE DOIT JAMAIS contenir\n section "en attente".\n4.1.3.2. Paramètres locaux actuels\nUNIQUEMENT l’appareil peut changer la section "actuelle" des "paramètres locaux".\n Tout le monde changera la section "en attente" et attendra que les modifications soient apportées.\n propagé à la section "en cours" par le périphérique.\n4.1.4. Hors ligne\nLorsqu'il est impossible de contacter le serveur au démarrage, après notification, le périphérique DOIT utiliser le dernier\n paramètres locaux.\n4.1.5. Suppression de l'appareil du service\nSi le périphérique a été supprimé du service (GCP par exemple), une notification XMPP sera envoyée.\n envoyé à l'appareil. La notification sera au format suivant:\n/effacer\nÀ la réception d'une telle notification, le périphérique DOIT se rendre sur le serveur pour vérifier son état. Nuage\n Les périphériques d’impression DOIVENT utiliser:\n/ cloudprint / printer? printerid =\nLe périphérique DOIT recevoir une réponse HTTP réussie avec success = false et aucun périphérique / imprimante.\n la description. Cela signifie que le périphérique a été retiré du serveur et que le périphérique DOIT effacer ses\n informations d’authentification et passer en mode de paramètres d’usine par défaut.\nTOUTE heure à laquelle le périphérique reçoit une réponse indiquant qu'il a été supprimé à la suite de la\n / cloudprint / API (démarrage, notification des paramètres de mise à jour, ping quotidien), elle DOIT supprimer ses\n informations d'identification et aller en mode par défaut.\n4.2. API / privet / info\nL'info API est OBLIGATOIRE et DOIT être implémentée par tous les appareils. C'est une requête HTTP GET pour\n "/ privet / info" url: GET / privet / info HTTP / 1.1\nL'API info renvoie des informations de base sur un périphérique et les fonctionnalités qu'il prend en charge. Cette API\n NE DOIT jamais changer l’état du dispositif ni effectuer aucune action, car il est vulnérable aux attaques XSRF.\n C'est la SEULE API autorisée à avoir un en-tête "X-Privet-Token" vide. Les clients devraient\n API call / privet / info avec en-tête "X-Privet-Token" définie sur X-Privet-Token:\n ""\nL'API info DOIT renvoyer des données cohérentes avec les données disponibles dans l'enregistrement TXT lors de la découverte.\n4.2.1. Contribution\n/ privet / info L'API n'a pas de paramètre d'entrée.\n4.2.2. Revenir\nL'API / privet / info renvoie des informations de base sur le périphérique et les fonctionnalités prises en charge.\nLa colonne TXT indique le champ correspondant dans l’enregistrement DNS-SD TXT.
"},{"id":"text-25","type":"text","heading":"","plain_text":"Nom de la valeur\nType de valeur\nLa description\nSMS","html":"Nom de la valeur\nType de valeur\nLa description\nSMS
"},{"id":"text-26","type":"text","heading":"","plain_text":"version\nchaîne\nVersion la plus récente (major.minor) de l'API prise en charge, actuellement\n 1,0","html":"version\nchaîne\nVersion la plus récente (major.minor) de l'API prise en charge, actuellement\n 1,0
"},{"id":"text-27","type":"text","heading":"","plain_text":"Nom\nchaîne\nNom lisible par l'homme du périphérique.\nty","html":"Nom\nchaîne\nNom lisible par l'homme du périphérique.\nty
"},{"id":"text-28","type":"text","heading":"","plain_text":"la description\nchaîne\n(facultatif) Description de l'appareil. DEVRAIT être modifiable par\n utilisateur.\nRemarque","html":"la description\nchaîne\n(facultatif) Description de l'appareil. DEVRAIT être modifiable par\n utilisateur.\nRemarque
"},{"id":"text-29","type":"text","heading":"","plain_text":"url\nchaîne\nURL du serveur avec lequel cet appareil parle. L'URL DOIT inclure\n spécification du protocole, par exemple: https://www.google.com/cloudprint.\nurl","html":"url\nchaîne\nURL du serveur avec lequel cet appareil parle. L'URL DOIT inclure\n spécification du protocole, par exemple: https://www.google.com/cloudprint.\nurl
"},{"id":"text-30","type":"text","heading":"","plain_text":"type\nliste de chaînes\nListe des types d'appareils pris en charge.\ntype","html":"type\nliste de chaînes\nListe des types d'appareils pris en charge.\ntype
"},{"id":"text-31","type":"text","heading":"","plain_text":"identifiant\nchaîne\nIdentifiant de périphérique, vide si le périphérique n'a pas encore été enregistré.\nidentifiant","html":"identifiant\nchaîne\nIdentifiant de périphérique, vide si le périphérique n'a pas encore été enregistré.\nidentifiant
"},{"id":"text-32","type":"text","heading":"","plain_text":"état_périphérique\nchaîne\nEtat de l'appareil.tourner au ralenti signifie que l'appareil est\n prêtEn traitement signifie que le périphérique est occupé et que les fonctionnalités peuvent être limitées pendant un certain temps\n arrêté signifie que l'appareil ne fonctionne pas et que l'intervention de l'utilisateur est requise","html":"état_périphérique\nchaîne\nEtat de l'appareil.tourner au ralenti signifie que l'appareil est\n prêtEn traitement signifie que le périphérique est occupé et que les fonctionnalités peuvent être limitées pendant un certain temps\n arrêté signifie que l'appareil ne fonctionne pas et que l'intervention de l'utilisateur est requise
"},{"id":"text-33","type":"text","heading":"","plain_text":"état_connexion\nchaîne\nEtat de la connexion au serveur (base_url)\n en ligne – connexion disponible\n hors ligne – pas de connection\n de liaison – effectuer les étapes de démarrage\n pas configuré – la connexion n'a pas encore été configurée\n Un périphérique enregistré peut signaler son état de connexion en fonction de l'état de la notification.\n canal (par exemple, l'état de la connexion XMPP).\ncs","html":"état_connexion\nchaîne\nEtat de la connexion au serveur (base_url)\n en ligne – connexion disponible\n hors ligne – pas de connection\n de liaison – effectuer les étapes de démarrage\n pas configuré – la connexion n'a pas encore été configurée\n Un périphérique enregistré peut signaler son état de connexion en fonction de l'état de la notification.\n canal (par exemple, l'état de la connexion XMPP).\ncs
"},{"id":"text-34","type":"text","heading":"","plain_text":"fabricant\nchaîne\nNom du fabricant de l'appareil","html":"fabricant\nchaîne\nNom du fabricant de l'appareil
"},{"id":"text-35","type":"text","heading":"","plain_text":"modèle\nchaîne\nModèle de l'appareil","html":"modèle\nchaîne\nModèle de l'appareil
"},{"id":"text-36","type":"text","heading":"","plain_text":"numéro de série\nchaîne\nIdentifiant unique de l'appareil. Dans cette spécification, cela DOIT être\n un UUID. (Spec GCP 1.1)\n (facultatif) Nous vous recommandons vivement d’utiliser le même identifiant de numéro de série partout, donc différent.\n les clients peuvent identifier le même appareil. Par exemple, les imprimeurs implémentant IPP peuvent utiliser cette interface série.\n numéro d'identification dans le champ "printer-device-id".","html":"numéro de série\nchaîne\nIdentifiant unique de l'appareil. Dans cette spécification, cela DOIT être\n un UUID. (Spec GCP 1.1)\n (facultatif) Nous vous recommandons vivement d’utiliser le même identifiant de numéro de série partout, donc différent.\n les clients peuvent identifier le même appareil. Par exemple, les imprimeurs implémentant IPP peuvent utiliser cette interface série.\n numéro d'identification dans le champ "printer-device-id".
"},{"id":"text-37","type":"text","heading":"","plain_text":"firmware\nchaîne\nVersion du firmware de l'appareil","html":"firmware\nchaîne\nVersion du firmware de l'appareil
"},{"id":"text-38","type":"text","heading":"","plain_text":"la disponibilité\nint\nNombre de secondes à partir du démarrage du périphérique.","html":"la disponibilité\nint\nNombre de secondes à partir du démarrage du périphérique.
"},{"id":"text-39","type":"text","heading":"","plain_text":"setup_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n instructions d'installation","html":"setup_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n instructions d'installation
"},{"id":"text-40","type":"text","heading":"","plain_text":"support_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n support, informations FAQ","html":"support_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n support, informations FAQ
"},{"id":"text-41","type":"text","heading":"","plain_text":"update_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n mettre à jour les instructions du firmware","html":"update_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n mettre à jour les instructions du firmware
"},{"id":"text-42","type":"text","heading":"","plain_text":"x-privet-token\nchaîne\nValeur de la X-Privet-Token en-tête qui a\n à transmettre à toutes les API pour empêcher les attaques XSSI et XSRF. Voir 6.1. pour plus de détails.","html":"x-privet-token\nchaîne\nValeur de la X-Privet-Token en-tête qui a\n à transmettre à toutes les API pour empêcher les attaques XSSI et XSRF. Voir 6.1. pour plus de détails.
"},{"id":"text-43","type":"text","heading":"","plain_text":"api\ndescription des API\nListe des API prises en charge (décrites ci-dessous)","html":"api\ndescription des API\nListe des API prises en charge (décrites ci-dessous)
"},{"id":"text-44","type":"text","heading":"","plain_text":"état sémantique\nJSON\n(facultatif) Etat sémantique de l'appareil en\n Format CloudDeviceState.","html":"état sémantique\nJSON\n(facultatif) Etat sémantique de l'appareil en\n Format CloudDeviceState.
"},{"id":"text-45","type":"text","heading":"","plain_text":"api – est une liste JSON contenant la liste des API disponibles via le réseau local. Remarque\n toutes les API ne sont peut-être pas disponibles simultanément sur le réseau local. Par exemple, un nouveau\n L'appareil connecté ne doit supporter que l'API / Register:","html":"api – est une liste JSON contenant la liste des API disponibles via le réseau local. Remarque\n toutes les API ne sont peut-être pas disponibles simultanément sur le réseau local. Par exemple, un nouveau\n L'appareil connecté ne doit supporter que l'API / Register:
"},{"id":"text-46","type":"text","heading":"","plain_text":""api": [\n \"/privet/register\",\n]","html":""api": [\n "/privet/register",\n]
"},{"id":"text-47","type":"text","heading":"","plain_text":"Une fois l'enregistrement de l'appareil terminé, l'appareil DEVRAIT cesser de prendre en charge l'API / register. le\nLe périphérique doit également vérifier auprès du service afin de déterminer quelles API peuvent être exposées sur le serveur local.\nréseau. Par exemple:","html":"Une fois l'enregistrement de l'appareil terminé, l'appareil DEVRAIT cesser de prendre en charge l'API / register. le\nLe périphérique doit également vérifier auprès du service afin de déterminer quelles API peuvent être exposées sur le serveur local.\nréseau. Par exemple:
"},{"id":"text-48","type":"text","heading":"","plain_text":""api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n]","html":""api": [\n "/privet/accesstoken",\n "/privet/capabilities",\n "/privet/printer/submitdoc",\n]
"},{"id":"text-49","type":"text","heading":"","plain_text":"Les API suivantes sont disponibles à ce moment:","html":"Les API suivantes sont disponibles à ce moment:
"},{"id":"text-50","type":"text","heading":"","plain_text":"/ privet / register – API pour l'enregistrement de périphérique sur le réseau local. (voir\n / privet / register API pour plus de détails). Cette API DOIT être cachée une fois le périphérique réussi.\n enregistré dans le nuage.\n/ privet / accesstoken – API permettant de demander un jeton d’accès à l’appareil (voir\n / privet / accesstoken API pour plus de détails).\n/ privet / capacités – API permettant de récupérer les capacités du périphérique (voir / privet / capacités\n API pour plus de détails).\n/ privet / printer / * – API spécifique au type de périphérique "imprimante", voir imprimante\n API spécifiques pour plus de détails.","html":"/ privet / register – API pour l'enregistrement de périphérique sur le réseau local. (voir\n / privet / register API pour plus de détails). Cette API DOIT être cachée une fois le périphérique réussi.\n enregistré dans le nuage.\n/ privet / accesstoken – API permettant de demander un jeton d’accès à l’appareil (voir\n / privet / accesstoken API pour plus de détails).\n/ privet / capacités – API permettant de récupérer les capacités du périphérique (voir / privet / capacités\n API pour plus de détails).\n/ privet / printer / * – API spécifique au type de périphérique "imprimante", voir imprimante\n API spécifiques pour plus de détails.
"},{"id":"text-51","type":"text","heading":"","plain_text":"Voici un exemple de réponse / privet / info. (Notez le manque de l’API / privet / register, car\nce périphérique est déjà enregistré):","html":"Voici un exemple de réponse / privet / info. (Notez le manque de l’API / privet / register, car\nce périphérique est déjà enregistré):
"},{"id":"text-52","type":"text","heading":"","plain_text":" "version": "1.0",\n "name": "l’imprimante de Gene",\n "description": "Imprimante connectée via un connecteur Chrome",\n "url": "https://www.google.com/cloudprint",\n "type": [\n \"printer\"\n ],\n "id": "11111111-2222-3333-4444-555555555555",\n "device_state": "inactif",\n "connection_state": "en ligne",\n "fabricant": "Google",\n "modèle": "Google Chrome",\n "numéro de série": "1111-22222-33333-4444",\n "firmware": "24.0.1312.52",\n "disponibilité": 600,\n "setup_url": "http://support.google.com/cloudprint/answer/1686197/?hl=fr",\n "support_url": "http://support.google.com/cloudprint/?hl=fr",\n "update_url": "http://support.google.com/cloudprint/?hl=fr",\n "x-privet-token": "AIp06DjQd80yMoGYuGmT_VDAApuBZbInsQ: 1358377509659",\n "api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n ]","html":""version": "1.0",\n "name": "l’imprimante de Gene",\n "description": "Imprimante connectée via un connecteur Chrome",\n "url": "https://www.google.com/cloudprint",\n "type": [\n "printer"\n ],\n "id": "11111111-2222-3333-4444-555555555555",\n "device_state": "inactif",\n "connection_state": "en ligne",\n "fabricant": "Google",\n "modèle": "Google Chrome",\n "numéro de série": "1111-22222-33333-4444",\n "firmware": "24.0.1312.52",\n "disponibilité": 600,\n "setup_url": "http://support.google.com/cloudprint/answer/1686197/?hl=fr",\n "support_url": "http://support.google.com/cloudprint/?hl=fr",\n "update_url": "http://support.google.com/cloudprint/?hl=fr",\n "x-privet-token": "AIp06DjQd80yMoGYuGmT_VDAApuBZbInsQ: 1358377509659",\n "api": [\n "/privet/accesstoken",\n "/privet/capabilities",\n "/privet/printer/submitdoc",\n ]
"},{"id":"text-53","type":"text","heading":"","plain_text":"Voici un exemple de réponse / privet / info pour une imprimante à court d’encre (avis\n état de sémantique):","html":"Voici un exemple de réponse / privet / info pour une imprimante à court d’encre (avis\n état de sémantique):
"},{"id":"text-54","type":"text","heading":"","plain_text":"{\n "version": "1.0",\n "name": "l’imprimante de Gene",\n "description": "Imprimante connectée via un connecteur Chrome",\n "url": "https://www.google.com/cloudprint",\n "type": [\n \"printer\"\n ],\n "id": "11111111-2222-3333-4444-555555555555",\n "device_state": "stoppé",\n "connection_state": "en ligne",\n "fabricant": "Google",\n "modèle": "Google Chrome",\n "numéro de série": "1111-22222-33333-4444",\n "firmware": "24.0.1312.52",\n "disponibilité": 600,\n "setup_url": "http://support.google.com/cloudprint/answer/1686197/?hl=fr",\n "support_url": "http://support.google.com/cloudprint/?hl=fr",\n "update_url": "http://support.google.com/cloudprint/?hl=fr",\n "x-privet-token": "AIp06DjQd80yMoGYuGmT_VDAApuBZbInsQ: 1358377509659",\n "api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n ],\n "état sémantique": \n "version": "1.0",\n "imprimante": \n "state": "STOPPED",\n "marker_state": \n "article": [\n \n \"vendor_id\": \"ink\",\n \"state\": \"EXHAUSTED\",\n \"level_percent\": 0\n \n ]\n \n \n \n}","html":"{\n "version": "1.0",\n "name": "l’imprimante de Gene",\n "description": "Imprimante connectée via un connecteur Chrome",\n "url": "https://www.google.com/cloudprint",\n "type": [\n "printer"\n ],\n "id": "11111111-2222-3333-4444-555555555555",\n "device_state": "stoppé",\n "connection_state": "en ligne",\n "fabricant": "Google",\n "modèle": "Google Chrome",\n "numéro de série": "1111-22222-33333-4444",\n "firmware": "24.0.1312.52",\n "disponibilité": 600,\n "setup_url": "http://support.google.com/cloudprint/answer/1686197/?hl=fr",\n "support_url": "http://support.google.com/cloudprint/?hl=fr",\n "update_url": "http://support.google.com/cloudprint/?hl=fr",\n "x-privet-token": "AIp06DjQd80yMoGYuGmT_VDAApuBZbInsQ: 1358377509659",\n "api": [\n "/privet/accesstoken",\n "/privet/capabilities",\n "/privet/printer/submitdoc",\n ],\n "état sémantique": \n "version": "1.0",\n "imprimante": \n "state": "STOPPED",\n "marker_state": \n "article": [\n \n "vendor_id": "ink",\n "state": "EXHAUSTED",\n "level_percent": 0\n \n ]\n \n \n \n}
"},{"id":"text-55","type":"text","heading":"","plain_text":"4.2.3. les erreurs\n/ privet / info API devrait SEULEMENT renvoyer une erreur si X-Privet-Token l'en-tête est manquant. Il\n DOIT être une erreur HTTP 400:\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\n4.3. / privet / register API\n/ privet / register est facultative. C'est une requête HTTP POST. / privet / register API DOIT vérifier\n pour une validité X-Privet-Token entête. Le périphérique DOIT implémenter cette API sur\n "/ privet / register" url:","html":"4.2.3. les erreurs\n/ privet / info API devrait SEULEMENT renvoyer une erreur si X-Privet-Token l'en-tête est manquant. Il\n DOIT être une erreur HTTP 400:\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\n4.3. / privet / register API\n/ privet / register est facultative. C'est une requête HTTP POST. / privet / register API DOIT vérifier\n pour une validité X-Privet-Token entête. Le périphérique DOIT implémenter cette API sur\n "/ privet / register" url:
"},{"id":"text-56","type":"text","heading":"","plain_text":"POST /privet/register?action=start&user=user@domain.com HTTP / 1.1\nPOST /privet/register?action=complete&user=user@domain.com HTTP / 1.1","html":"POST /privet/register?action=start&user=user@domain.com HTTP / 1.1\nPOST /privet/register?action=complete&user=user@domain.com HTTP / 1.1
"},{"id":"text-57","type":"text","heading":"","plain_text":"L’appareil doit exposer l’API / privet / register UNIQUEMENT lorsqu’il autorise l’enregistrement anonyme à la\n moment. Par exemple:","html":"L’appareil doit exposer l’API / privet / register UNIQUEMENT lorsqu’il autorise l’enregistrement anonyme à la\n moment. Par exemple:
"},{"id":"text-58","type":"text","heading":"","plain_text":"Lorsque le périphérique est allumé (ou après avoir cliqué sur un bouton spécial du périphérique) et n’a pas\n été enregistré, il devrait exposer l’API / privet / register pour permettre à un utilisateur du répertoire local\n réseau pour réclamer l’imprimante.\nUne fois l’enregistrement terminé, le périphérique doit cesser d’exposer l’API / privet / register à\n empêcher un autre utilisateur du réseau local de récupérer le périphérique.\nCertains appareils peuvent avoir différentes façons d’enregistrer des appareils et ne doivent pas exposer le\n / privet / register à tous (par exemple, le connecteur Chrome Cloud Print).","html":"Lorsque le périphérique est allumé (ou après avoir cliqué sur un bouton spécial du périphérique) et n’a pas\n été enregistré, il devrait exposer l’API / privet / register pour permettre à un utilisateur du répertoire local\n réseau pour réclamer l’imprimante.\nUne fois l’enregistrement terminé, le périphérique doit cesser d’exposer l’API / privet / register à\n empêcher un autre utilisateur du réseau local de récupérer le périphérique.\nCertains appareils peuvent avoir différentes façons d’enregistrer des appareils et ne doivent pas exposer le\n / privet / register à tous (par exemple, le connecteur Chrome Cloud Print).
"},{"id":"text-59","type":"text","heading":"","plain_text":"Le processus d’enregistrement se déroule en 3 étapes (voir Enregistrement anonyme pour Cloud Print).","html":"Le processus d’enregistrement se déroule en 3 étapes (voir Enregistrement anonyme pour Cloud Print).
"},{"id":"text-60","type":"text","heading":"","plain_text":"Lancer le processus d'inscription anonyme.\nUn client initie ce processus en appelant l'API / privet / register. L'appareil peut attendre\n confirmation de l'utilisateur à ce moment.\nObtenez le jeton de réclamation.","html":"Lancer le processus d'inscription anonyme.\nUn client initie ce processus en appelant l'API / privet / register. L'appareil peut attendre\n confirmation de l'utilisateur à ce moment.\nObtenez le jeton de réclamation.
"},{"id":"text-61","type":"text","heading":"","plain_text":"Le client interroge pour savoir quand l'appareil est prêt à continuer. Une fois que l'appareil est prêt, il\n envoie une demande au serveur pour récupérer le jeton d'enregistrement et l'URL d'inscription. Jeton reçu\n et URL DEVRAIT être retourné au client. Au cours de cette étape, si le périphérique reçoit un autre appel pour\n initialiser l'enregistrement, il devrait:","html":"Le client interroge pour savoir quand l'appareil est prêt à continuer. Une fois que l'appareil est prêt, il\n envoie une demande au serveur pour récupérer le jeton d'enregistrement et l'URL d'inscription. Jeton reçu\n et URL DEVRAIT être retourné au client. Au cours de cette étape, si le périphérique reçoit un autre appel pour\n initialiser l'enregistrement, il devrait:
"},{"id":"text-62","type":"text","heading":"","plain_text":"Si c’est le même utilisateur qui a commencé l’enregistrement, supprimez toutes les données précédentes (le cas échéant) et démarrez le système.\n un nouveau processus d'inscription.\nS'il s'agit d'un utilisateur différent, retourne une erreur device_busy et un délai d'attente de 30 secondes.","html":"Si c’est le même utilisateur qui a commencé l’enregistrement, supprimez toutes les données précédentes (le cas échéant) et démarrez le système.\n un nouveau processus d'inscription.\nS'il s'agit d'un utilisateur différent, retourne une erreur device_busy et un délai d'attente de 30 secondes.
"},{"id":"text-63","type":"text","heading":"","plain_text":"Processus d'inscription complet.\nUne fois que le client a réclamé le périphérique, il doit lui notifier son achèvement.\n enregistrement. Une fois le processus d'enregistrement terminé, l'appareil doit envoyer une mise à jour.\n annonce, y compris l'ID de périphérique nouvellement acquis.\nRemarque: lorsque le périphérique traite un appel d'API / privet / register, aucune autre API / privet / register\n les appels peuvent être traités simultanément. Le périphérique DOIT retourner l'erreur device_busy et 30 secondes\n temps libre.\nLa confirmation de l'utilisateur pour l'enregistrement sur l'appareil est fortement recommandée. Si mis en œuvre, le\n le périphérique DOIT attendre la confirmation de l'utilisateur APRÈS qu'il reçoive un / privet / register? action = start API\n appel. Le client appellera / privet / register? Action = getClaimToken pour savoir quand\n la confirmation de l'utilisateur est terminée et le jeton de réclamation est disponible. Si l'utilisateur annule son inscription le\n l'appareil (par exemple, appuie sur le bouton Annuler), l'erreur user_cancel DOIT être renvoyée. Si l'utilisateur\n l’enregistrement n’a pas été confirmé dans un certain délai, l’erreur confirmation_timeout DOIT être\n revenu. Voir la section des valeurs par défaut pour plus de détails.\n4.3.1. Contribution\nL'API / privet / register a les paramètres d'entrée suivants:","html":"Processus d'inscription complet.\nUne fois que le client a réclamé le périphérique, il doit lui notifier son achèvement.\n enregistrement. Une fois le processus d'enregistrement terminé, l'appareil doit envoyer une mise à jour.\n annonce, y compris l'ID de périphérique nouvellement acquis.\nRemarque: lorsque le périphérique traite un appel d'API / privet / register, aucune autre API / privet / register\n les appels peuvent être traités simultanément. Le périphérique DOIT retourner l'erreur device_busy et 30 secondes\n temps libre.\nLa confirmation de l'utilisateur pour l'enregistrement sur l'appareil est fortement recommandée. Si mis en œuvre, le\n le périphérique DOIT attendre la confirmation de l'utilisateur APRÈS qu'il reçoive un / privet / register? action = start API\n appel. Le client appellera / privet / register? Action = getClaimToken pour savoir quand\n la confirmation de l'utilisateur est terminée et le jeton de réclamation est disponible. Si l'utilisateur annule son inscription le\n l'appareil (par exemple, appuie sur le bouton Annuler), l'erreur user_cancel DOIT être renvoyée. Si l'utilisateur\n l’enregistrement n’a pas été confirmé dans un certain délai, l’erreur confirmation_timeout DOIT être\n revenu. Voir la section des valeurs par défaut pour plus de détails.\n4.3.1. Contribution\nL'API / privet / register a les paramètres d'entrée suivants:
"},{"id":"text-64","type":"text","heading":"","plain_text":"Nom\nValeur","html":"Nom\nValeur
"},{"id":"text-65","type":"text","heading":"","plain_text":"action\nPeut être l'un des suivants:\n début – pour commencer le processus d'inscription\n getClaimToken – récupérer le jeton de réclamation pour le périphérique\n Annuler – annuler le processus d'inscription\n Achevée – terminer le processus d'inscription","html":"action\nPeut être l'un des suivants:\n début – pour commencer le processus d'inscription\n getClaimToken – récupérer le jeton de réclamation pour le périphérique\n Annuler – annuler le processus d'inscription\n Achevée – terminer le processus d'inscription
"},{"id":"text-66","type":"text","heading":"","plain_text":"utilisateur\nEmail de l'utilisateur qui réclamera cet appareil.","html":"utilisateur\nEmail de l'utilisateur qui réclamera cet appareil.
"},{"id":"text-67","type":"text","heading":"","plain_text":"Le périphérique DOIT vérifier que l’adresse électronique de toutes les actions (start, getClaimToken, annuler,\n complète) correspond.\n4.3.2. Revenir\nL'API / privet / register renvoie les données suivantes:","html":"Le périphérique DOIT vérifier que l’adresse électronique de toutes les actions (start, getClaimToken, annuler,\n complète) correspond.\n4.3.2. Revenir\nL'API / privet / register renvoie les données suivantes:
"},{"id":"text-68","type":"text","heading":"","plain_text":"Nom de la valeur\nType de valeur\nLa description","html":"Nom de la valeur\nType de valeur\nLa description
"},{"id":"text-69","type":"text","heading":"","plain_text":"action\nchaîne\nMême action que dans le paramètre d'entrée.","html":"action\nchaîne\nMême action que dans le paramètre d'entrée.
"},{"id":"text-70","type":"text","heading":"","plain_text":"utilisateur\nchaîne (optionnel)\nMême utilisateur que dans le paramètre d'entrée (peut être manquant, si\n omis dans l'entrée).","html":"utilisateur\nchaîne (optionnel)\nMême utilisateur que dans le paramètre d'entrée (peut être manquant, si\n omis dans l'entrée).
"},{"id":"text-71","type":"text","heading":"","plain_text":"jeton\nchaîne (optionnel)\nJeton d'inscription (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler").","html":"jeton\nchaîne (optionnel)\nJeton d'inscription (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler").
"},{"id":"text-72","type":"text","heading":"","plain_text":"claim_url\nchaîne (optionnel)\nURL d'enregistrement (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler"). Pour les imprimantes en nuage, il faut\n être "complete_invite_url" reçu du serveur.","html":"claim_url\nchaîne (optionnel)\nURL d'enregistrement (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler"). Pour les imprimantes en nuage, il faut\n être "complete_invite_url" reçu du serveur.
"},{"id":"text-73","type":"text","heading":"","plain_text":"automation_claim_url\nchaîne (optionnel)\nURL d'enregistrement (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler"). Pour les imprimantes en nuage, il faut\n être "automatic_invite_url" reçu du serveur.","html":"automation_claim_url\nchaîne (optionnel)\nURL d'enregistrement (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler"). Pour les imprimantes en nuage, il faut\n être "automatic_invite_url" reçu du serveur.
"},{"id":"text-74","type":"text","heading":"","plain_text":"Reference de l'appareil\nchaîne (optionnel)\nNouvel identifiant d'appareil (omis pour la réponse "start",\n obligatoire pour "complet").","html":"Reference de l'appareil\nchaîne (optionnel)\nNouvel identifiant d'appareil (omis pour la réponse "start",\n obligatoire pour "complet").
"},{"id":"text-75","type":"text","heading":"","plain_text":"Le périphérique DOIT retourner son identifiant de périphérique dans la réponse de l'API / privet / info UNIQUEMENT après l'enregistrement.\n Achevée.\nExemple 1:","html":"Le périphérique DOIT retourner son identifiant de périphérique dans la réponse de l'API / privet / info UNIQUEMENT après l'enregistrement.\n Achevée.\nExemple 1:
"},{"id":"text-76","type":"text","heading":"","plain_text":" "action": "start",\n "utilisateur": "utilisateur@domaine.com",","html":""action": "start",\n "utilisateur": "utilisateur@domaine.com",
"},{"id":"text-77","type":"text","heading":"","plain_text":"Exemple 2:","html":"Exemple 2:
"},{"id":"text-78","type":"text","heading":"","plain_text":" "action": "getClaimToken",\n "utilisateur": "utilisateur@domaine.com",\n "jeton": "AAA111222333444555666777",\n "claim_url": "https://domain.com/SoMeUrL",","html":""action": "getClaimToken",\n "utilisateur": "utilisateur@domaine.com",\n "jeton": "AAA111222333444555666777",\n "claim_url": "https://domain.com/SoMeUrL",
"},{"id":"text-79","type":"text","heading":"","plain_text":"Exemple 3:","html":"Exemple 3:
"},{"id":"text-80","type":"text","heading":"","plain_text":" "action": "complet",\n "utilisateur": "utilisateur@domaine.com",\n "device_id": "11111111-2222-3333-4444-555555555555",","html":""action": "complet",\n "utilisateur": "utilisateur@domaine.com",\n "device_id": "11111111-2222-3333-4444-555555555555",
"},{"id":"text-81","type":"text","heading":"","plain_text":"4.3.3. les erreurs\nL'API / privet / register peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):","html":"4.3.3. les erreurs\nL'API / privet / register peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):
"},{"id":"text-82","type":"text","heading":"","plain_text":"Erreur\nLa description","html":"Erreur\nLa description
"},{"id":"text-83","type":"text","heading":"","plain_text":"device_busy\nLe périphérique est occupé et ne peut pas effectuer l’action demandée. Recommencez\n après timeout.","html":"device_busy\nLe périphérique est occupé et ne peut pas effectuer l’action demandée. Recommencez\n après timeout.
"},{"id":"text-84","type":"text","heading":"","plain_text":"waiting_user_action\nEn réponse à "getClaimToken", cette erreur indique que le\n le périphérique est toujours en attente de confirmation de l'utilisateur, et la requête "getClaimToken" doit être réessayée après\n temps libre.","html":"waiting_user_action\nEn réponse à "getClaimToken", cette erreur indique que le\n le périphérique est toujours en attente de confirmation de l'utilisateur, et la requête "getClaimToken" doit être réessayée après\n temps libre.
"},{"id":"text-85","type":"text","heading":"","plain_text":"user_cancel\nL'utilisateur a explicitement annulé le processus d'inscription depuis l'appareil.","html":"user_cancel\nL'utilisateur a explicitement annulé le processus d'inscription depuis l'appareil.
"},{"id":"text-86","type":"text","heading":"","plain_text":"confirmation_timeout\nLa confirmation de l'utilisateur expire.","html":"confirmation_timeout\nLa confirmation de l'utilisateur expire.
"},{"id":"text-87","type":"text","heading":"","plain_text":"invalide_action\nUne action invalide est appelée. Par exemple, si le client appelé\n action = terminé avant d'appeler action = start et action = getClaimToken.","html":"invalide_action\nUne action invalide est appelée. Par exemple, si le client appelé\n action = terminé avant d'appeler action = start et action = getClaimToken.
"},{"id":"text-88","type":"text","heading":"","plain_text":"parent_invalide\nParamètres non valides spécifiés dans la demande. (Paramètres inconnus\n doit être ignoré pour une compatibilité future). Par exemple, renvoyez ceci si le client\n appelé action = inconnu ou utilisateur =.","html":"parent_invalide\nParamètres non valides spécifiés dans la demande. (Paramètres inconnus\n doit être ignoré pour une compatibilité future). Par exemple, renvoyez ceci si le client\n appelé action = inconnu ou utilisateur =.
"},{"id":"text-89","type":"text","heading":"","plain_text":"device_config_error\nLa date / heure (ou certains autres paramètres) est incorrecte sur l'appareil\n côté. L'utilisateur doit aller (sur le site Web interne du périphérique) et configurer les paramètres du périphérique.","html":"device_config_error\nLa date / heure (ou certains autres paramètres) est incorrecte sur l'appareil\n côté. L'utilisateur doit aller (sur le site Web interne du périphérique) et configurer les paramètres du périphérique.
"},{"id":"text-90","type":"text","heading":"","plain_text":"hors ligne\nL’appareil est actuellement hors ligne et ne peut pas communiquer avec le serveur.","html":"hors ligne\nL’appareil est actuellement hors ligne et ne peut pas communiquer avec le serveur.
"},{"id":"text-91","type":"text","heading":"","plain_text":"erreur du serveur\nErreur du serveur pendant le processus d'inscription.","html":"erreur du serveur\nErreur du serveur pendant le processus d'inscription.
"},{"id":"text-92","type":"text","heading":"","plain_text":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la requête.","html":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la requête.
"},{"id":"text-93","type":"text","heading":"","plain_text":"Le périphérique DOIT cesser d’exposer l’API / privet / register une fois l’enregistrement effectué avec succès.\n terminé. Si le périphérique n'expose pas l'API / privet / register, il DOIT renvoyer l'erreur HTTP 404.\n Par conséquent, si un périphérique est déjà enregistré, l'appel de cette API DOIT renvoyer 404. Si le\n L'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer l'erreur HTTP 400.\n4.4. / privet / accesstoken API\n/ privet / accesstoken API est FACULTATIF. C'est une requête HTTP GET. / privet / accesstoken API DOIT vérifier\npour un en-tête "X-Privet-Token" valide. Le périphérique DOIT implémenter cette API sur le\n"/ privet / accesstoken" url:\nGET / privet / accesstoken HTTP / 1.1\nLorsque le périphérique reçoit l'appel de l'API / accesstoken, il doit appeler le serveur pour récupérer le\n jeton d'accès pour l'utilisateur donné et renvoyer le jeton au client. Le client utilisera ensuite le\n jeton d'accès pour accéder à cet appareil via le cloud.\nLes périphériques Cloud Print DOIVENT appeler l'API suivante:\n/ cloudprint / proximitétoken\net passez les paramètres "printerid =" et "user" du local\nAPI. En cas de succès, la réponse du serveur contiendra l'objet suivant:","html":"Le périphérique DOIT cesser d’exposer l’API / privet / register une fois l’enregistrement effectué avec succès.\n terminé. Si le périphérique n'expose pas l'API / privet / register, il DOIT renvoyer l'erreur HTTP 404.\n Par conséquent, si un périphérique est déjà enregistré, l'appel de cette API DOIT renvoyer 404. Si le\n L'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer l'erreur HTTP 400.\n4.4. / privet / accesstoken API\n/ privet / accesstoken API est FACULTATIF. C'est une requête HTTP GET. / privet / accesstoken API DOIT vérifier\npour un en-tête "X-Privet-Token" valide. Le périphérique DOIT implémenter cette API sur le\n"/ privet / accesstoken" url:\nGET / privet / accesstoken HTTP / 1.1\nLorsque le périphérique reçoit l'appel de l'API / accesstoken, il doit appeler le serveur pour récupérer le\n jeton d'accès pour l'utilisateur donné et renvoyer le jeton au client. Le client utilisera ensuite le\n jeton d'accès pour accéder à cet appareil via le cloud.\nLes périphériques Cloud Print DOIVENT appeler l'API suivante:\n/ cloudprint / proximitétoken\net passez les paramètres "printerid =" et "user" du local\nAPI. En cas de succès, la réponse du serveur contiendra l'objet suivant:
"},{"id":"text-94","type":"text","heading":"","plain_text":""proximité_token": \n "utilisateur": "utilisateur@domaine.com",\n "jeton": "AAA111222333444555666777",\n "expires_in": 600","html":""proximité_token": \n "utilisateur": "utilisateur@domaine.com",\n "jeton": "AAA111222333444555666777",\n "expires_in": 600
"},{"id":"text-95","type":"text","heading":"","plain_text":"Les périphériques Cloud Print DOIVENT transmettre la valeur de l’objet "proximité_token" dans la réponse.\naux appels d’API locaux / privet / accesstoken. Il est plus avantageux (à l’avenir) que l’appareil puisse\npasse TOUS les paramètres (y compris ceux qui ne sont pas décrits dans cette spécification).\n4.4.1. Contribution\nL'API / privet / accesstoken a les paramètres d'entrée suivants:","html":"Les périphériques Cloud Print DOIVENT transmettre la valeur de l’objet "proximité_token" dans la réponse.\naux appels d’API locaux / privet / accesstoken. Il est plus avantageux (à l’avenir) que l’appareil puisse\npasse TOUS les paramètres (y compris ceux qui ne sont pas décrits dans cette spécification).\n4.4.1. Contribution\nL'API / privet / accesstoken a les paramètres d'entrée suivants:
"},{"id":"text-96","type":"text","heading":"","plain_text":"Nom\nValeur","html":"Nom\nValeur
"},{"id":"text-97","type":"text","heading":"","plain_text":"utilisateur\nEmail de l'utilisateur qui a eu l'intention d'utiliser ce jeton d'accès. Peut être vide dans le\n demande.","html":"utilisateur\nEmail de l'utilisateur qui a eu l'intention d'utiliser ce jeton d'accès. Peut être vide dans le\n demande.
"},{"id":"text-98","type":"text","heading":"","plain_text":"4.4.2. Revenir\n/ privet / accesstoken L'API renvoie les données suivantes:","html":"4.4.2. Revenir\n/ privet / accesstoken L'API renvoie les données suivantes:
"},{"id":"text-99","type":"text","heading":"","plain_text":"Nom de la valeur\nType de valeur\nLa description","html":"Nom de la valeur\nType de valeur\nLa description
"},{"id":"text-100","type":"text","heading":"","plain_text":"jeton\nchaîne\nJeton d'accès renvoyé par le serveur","html":"jeton\nchaîne\nJeton d'accès renvoyé par le serveur
"},{"id":"text-101","type":"text","heading":"","plain_text":"utilisateur\nchaîne\nMême utilisateur que dans le paramètre d'entrée.","html":"utilisateur\nchaîne\nMême utilisateur que dans le paramètre d'entrée.
"},{"id":"text-102","type":"text","heading":"","plain_text":"expire dans\nint\nNombre de secondes jusqu'à l'expiration de ce jeton. Reçu de\n le serveur et passé dans cette réponse.","html":"expire dans\nint\nNombre de secondes jusqu'à l'expiration de ce jeton. Reçu de\n le serveur et passé dans cette réponse.
"},{"id":"text-103","type":"text","heading":"","plain_text":"Exemple:","html":"Exemple:
"},{"id":"text-104","type":"text","heading":"","plain_text":" "jeton": "AAA111222333444555666777",\n "utilisateur": "utilisateur@domaine.com",\n "expires_in": 600","html":""jeton": "AAA111222333444555666777",\n "utilisateur": "utilisateur@domaine.com",\n "expires_in": 600
"},{"id":"text-105","type":"text","heading":"","plain_text":"4.4.3. les erreurs\nL'API / privet / accesstoken peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):","html":"4.4.3. les erreurs\nL'API / privet / accesstoken peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):
"},{"id":"text-106","type":"text","heading":"","plain_text":"Erreur\nLa description","html":"Erreur\nLa description
"},{"id":"text-107","type":"text","heading":"","plain_text":"hors ligne\nL'appareil est actuellement hors ligne et ne peut pas parler au serveur.","html":"hors ligne\nL'appareil est actuellement hors ligne et ne peut pas parler au serveur.
"},{"id":"text-108","type":"text","heading":"","plain_text":"accès refusé\nDroits insuffisants. Accès refusé. L'appareil doit renvoyer cette\n erreur lorsque la demande a été explicitement refusée par le serveur.","html":"accès refusé\nDroits insuffisants. Accès refusé. L'appareil doit renvoyer cette\n erreur lorsque la demande a été explicitement refusée par le serveur.
"},{"id":"text-109","type":"text","heading":"","plain_text":"parent_invalide\nParamètres non valides spécifiés dans la demande. (Paramètres inconnus\n doit être ignoré pour une compatibilité future). Par exemple, si le client appelé\n / accesstoken? user = ou / accesstoken.","html":"parent_invalide\nParamètres non valides spécifiés dans la demande. (Paramètres inconnus\n doit être ignoré pour une compatibilité future). Par exemple, si le client appelé\n / accesstoken? user = ou / accesstoken.
"},{"id":"text-110","type":"text","heading":"","plain_text":"erreur du serveur\nErreur du serveur.","html":"erreur du serveur\nErreur du serveur.
"},{"id":"text-111","type":"text","heading":"","plain_text":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la demande.","html":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la demande.
"},{"id":"text-112","type":"text","heading":"","plain_text":"Si le périphérique n'expose pas l'API / privet / accesstoken, il DOIT renvoyer l'erreur HTTP 404. Si la\n L'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer l'erreur HTTP 400.\n4.5 / privet / API de capacités\n/ privet / features est facultatif. C'est une requête HTTP GET. / privet / functions API DOIT vérifier\npour un en-tête "X-Privet-Token" valide. Le périphérique DOIT implémenter cette API sur\nURL "/ privet / capacités":\nGET / privet / capacités HTTP / 1.1\nLorsque le périphérique reçoit / appel de l'API de fonctionnalités, si le périphérique est capable, il DEVRAIT contacter\nle serveur pour obtenir des capacités mises à jour. Par exemple, si une imprimante prend en charge la publication d'un travail d'impression\n(reçu localement) à travers le service Cloud Print, il devrait renvoyer les fonctionnalités que le\nLe service d'impression en nuage reviendrait. Cloud Print dans ce cas peut altérer l'imprimante d'origine\nfonctions en ajoutant de nouvelles fonctionnalités avant d’envoyer le travail à l’imprimante. Le plus\nLe cas courant est une liste de types de documents pris en charge. Si l'imprimante est hors ligne, elle devrait renvoyer\ntypes de documents qu'il prend en charge. Cependant, si l'imprimante est en ligne et enregistrée auprès de Cloud Print it\nDOIT retourner "* / *" parmi les types pris en charge. Le service Cloud Print sera exécuté\nla conversion nécessaire dans ce cas. Pour l’impression hors ligne, l’imprimante DOIT prendre en charge au moins la\nformat "image / pwg-raster".\n4.5.1. Contribution\nL'API / privet / functions a les paramètres d'entrée suivants:","html":"Si le périphérique n'expose pas l'API / privet / accesstoken, il DOIT renvoyer l'erreur HTTP 404. Si la\n L'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer l'erreur HTTP 400.\n4.5 / privet / API de capacités\n/ privet / features est facultatif. C'est une requête HTTP GET. / privet / functions API DOIT vérifier\npour un en-tête "X-Privet-Token" valide. Le périphérique DOIT implémenter cette API sur\nURL "/ privet / capacités":\nGET / privet / capacités HTTP / 1.1\nLorsque le périphérique reçoit / appel de l'API de fonctionnalités, si le périphérique est capable, il DEVRAIT contacter\nle serveur pour obtenir des capacités mises à jour. Par exemple, si une imprimante prend en charge la publication d'un travail d'impression\n(reçu localement) à travers le service Cloud Print, il devrait renvoyer les fonctionnalités que le\nLe service d'impression en nuage reviendrait. Cloud Print dans ce cas peut altérer l'imprimante d'origine\nfonctions en ajoutant de nouvelles fonctionnalités avant d’envoyer le travail à l’imprimante. Le plus\nLe cas courant est une liste de types de documents pris en charge. Si l'imprimante est hors ligne, elle devrait renvoyer\ntypes de documents qu'il prend en charge. Cependant, si l'imprimante est en ligne et enregistrée auprès de Cloud Print it\nDOIT retourner "* / *" parmi les types pris en charge. Le service Cloud Print sera exécuté\nla conversion nécessaire dans ce cas. Pour l’impression hors ligne, l’imprimante DOIT prendre en charge au moins la\nformat "image / pwg-raster".\n4.5.1. Contribution\nL'API / privet / functions a les paramètres d'entrée suivants:
"},{"id":"text-113","type":"text","heading":"","plain_text":"Nom\nValeur","html":"Nom\nValeur
"},{"id":"text-114","type":"text","heading":"","plain_text":"hors ligne\n(facultatif) Ne peut être que "hors ligne = 1". Dans ce cas, l'appareil doit retourner\n capacités pour une utilisation hors connexion (si elles sont différentes des capacités "en ligne").","html":"hors ligne\n(facultatif) Ne peut être que "hors ligne = 1". Dans ce cas, l'appareil doit retourner\n capacités pour une utilisation hors connexion (si elles sont différentes des capacités "en ligne").
"},{"id":"text-115","type":"text","heading":"","plain_text":"4.5.2. Revenir\nL'API / privet / features renvoie les fonctionnalités de périphérique dans le fichier JSON CDD (Cloud Device Description)\nformat (voir le document CDD pour plus de détails). Les imprimantes au minimum DOIVENT renvoyer une liste des types pris en charge\nici. Par exemple, une imprimante Cloud Ready actuellement en ligne peut renvoyer quelque chose comme ceci (à\nle minimum):","html":"4.5.2. Revenir\nL'API / privet / features renvoie les fonctionnalités de périphérique dans le fichier JSON CDD (Cloud Device Description)\nformat (voir le document CDD pour plus de détails). Les imprimantes au minimum DOIVENT renvoyer une liste des types pris en charge\nici. Par exemple, une imprimante Cloud Ready actuellement en ligne peut renvoyer quelque chose comme ceci (à\nle minimum):
"},{"id":"text-116","type":"text","heading":"","plain_text":" "version": "1.0",\n "imprimante": \n "supported_content_type": [\n \n \"content_type\": \"application/pdf\",\n \"min_version\": \"1.4\"\n ,\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"image/jpeg\" ,\n \"content_type\": \"*/*\" \n ]","html":""version": "1.0",\n "imprimante": \n "supported_content_type": [\n \n "content_type": "application/pdf",\n "min_version": "1.4"\n ,\n "content_type": "image/pwg-raster" ,\n "content_type": "image/jpeg" ,\n "content_type": "*/*" \n ]
"},{"id":"text-117","type":"text","heading":"","plain_text":"et quand il est déconnecté du serveur, il peut retourner:","html":"et quand il est déconnecté du serveur, il peut retourner:
"},{"id":"text-118","type":"text","heading":"","plain_text":" "version": "1.0",\n "imprimante": \n "supported_content_type": [\n \n \"content_type\": \"application/pdf\",\n \"min_version\": \"1.4\"\n ,\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"image/jpeg\" \n ]","html":""version": "1.0",\n "imprimante": \n "supported_content_type": [\n \n "content_type": "application/pdf",\n "min_version": "1.4"\n ,\n "content_type": "image/pwg-raster" ,\n "content_type": "image/jpeg" \n ]
"},{"id":"text-119","type":"text","heading":"","plain_text":"Remarque: Les imprimantes expriment la priorité du type de contenu pris en charge en utilisant la commande. Pour\n Par exemple, dans les exemples ci-dessus, l’imprimante indique qu’elle préfère les données "application / pdf" à\n "image / pwg-raster" et "image / jpeg". Les clients doivent respecter les priorités des imprimantes si possible\n (voir le document CDD pour plus de détails).\n4.5.3. les erreurs\nL'API / privet / features peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):","html":"Remarque: Les imprimantes expriment la priorité du type de contenu pris en charge en utilisant la commande. Pour\n Par exemple, dans les exemples ci-dessus, l’imprimante indique qu’elle préfère les données "application / pdf" à\n "image / pwg-raster" et "image / jpeg". Les clients doivent respecter les priorités des imprimantes si possible\n (voir le document CDD pour plus de détails).\n4.5.3. les erreurs\nL'API / privet / features peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):
"},{"id":"text-120","type":"text","heading":"","plain_text":"Erreur\nLa description","html":"Erreur\nLa description
"},{"id":"text-121","type":"text","heading":"","plain_text":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la requête.","html":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la requête.
"},{"id":"text-122","type":"text","heading":"","plain_text":"Si le périphérique n'expose pas l'API / privet / features, il DOIT renvoyer HTTP 404.\n Erreur. Si l'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer une erreur HTTP 400.\n4.6. les erreurs\nLes erreurs sont renvoyées par les API ci-dessus au format suivant:","html":"Si le périphérique n'expose pas l'API / privet / features, il DOIT renvoyer HTTP 404.\n Erreur. Si l'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer une erreur HTTP 400.\n4.6. les erreurs\nLes erreurs sont renvoyées par les API ci-dessus au format suivant:
"},{"id":"text-123","type":"text","heading":"","plain_text":"Nom de la valeur\nType de valeur\nLa description","html":"Nom de la valeur\nType de valeur\nLa description
"},{"id":"text-124","type":"text","heading":"","plain_text":"Erreur\nchaîne\nType d'erreur (défini par API)","html":"Erreur\nchaîne\nType d'erreur (défini par API)
"},{"id":"text-125","type":"text","heading":"","plain_text":"la description\nchaîne (optionnel)\nDescription lisible par l'homme de l'erreur.","html":"la description\nchaîne (optionnel)\nDescription lisible par l'homme de l'erreur.
"},{"id":"text-126","type":"text","heading":"","plain_text":"server_api\nchaîne (optionnel)\nEn cas d'erreur de serveur, ce champ contient\n l'API du serveur qui a échoué.","html":"server_api\nchaîne (optionnel)\nEn cas d'erreur de serveur, ce champ contient\n l'API du serveur qui a échoué.
"},{"id":"text-127","type":"text","heading":"","plain_text":"code_serveur\nint (facultatif)\nEn cas d'erreur de serveur, ce champ contient\n ce code d'erreur que le serveur a renvoyé.","html":"code_serveur\nint (facultatif)\nEn cas d'erreur de serveur, ce champ contient\n ce code d'erreur que le serveur a renvoyé.
"},{"id":"text-128","type":"text","heading":"","plain_text":"code_http_serveur\nint (facultatif)\nEn cas d'erreur HTTP du serveur, ce champ\n contient le code d'erreur HTTP serveur renvoyé.","html":"code_http_serveur\nint (facultatif)\nEn cas d'erreur HTTP du serveur, ce champ\n contient le code d'erreur HTTP serveur renvoyé.
"},{"id":"text-129","type":"text","heading":"","plain_text":"temps libre\nint (facultatif)\nNombre de secondes que le client attend avant\n nouvelle tentative (pour les erreurs récupérables uniquement). Le client DOIT randomiser le délai d’expiration réel de cette valeur sur\n une valeur de + 20%.","html":"temps libre\nint (facultatif)\nNombre de secondes que le client attend avant\n nouvelle tentative (pour les erreurs récupérables uniquement). Le client DOIT randomiser le délai d’expiration réel de cette valeur sur\n une valeur de + 20%.
"},{"id":"text-130","type":"text","heading":"","plain_text":"Toutes les API DOIVENT renvoyer une erreur HTTP 400 si l'en-tête X-Privet-Token est manquant.\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\nExemple 1:","html":"Toutes les API DOIVENT renvoyer une erreur HTTP 400 si l'en-tête X-Privet-Token est manquant.\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\nExemple 1:
"},{"id":"text-131","type":"text","heading":"","plain_text":" "erreur": "erreur_serveur",\n "description": "Service indisponible",\n "server_api": "/ submit",\n "code_http_serveur": 503","html":""erreur": "erreur_serveur",\n "description": "Service indisponible",\n "server_api": "/ submit",\n "code_http_serveur": 503
"},{"id":"text-132","type":"text","heading":"","plain_text":"Exemple 2:","html":"Exemple 2:
"},{"id":"text-133","type":"text","heading":"","plain_text":" "error": "printer_busy",\n "description": "L'imprimante est en train d'imprimer un autre travail",\n "timeout": 15","html":""error": "printer_busy",\n "description": "L'imprimante est en train d'imprimer un autre travail",\n "timeout": 15
"},{"id":"text-134","type":"text","heading":"","plain_text":"5. API d'imprimante\nL'un des types de périphérique pris en charge par ce protocole est le type imprimante. Les appareils supportant ce type PEUVENT\n implémenter certaines fonctionnalités spécifiques aux imprimantes. Idéalement, l’impression sur des imprimantes prêtes au cloud\n passer par un serveur Cloud Print:","html":"5. API d'imprimante\nL'un des types de périphérique pris en charge par ce protocole est le type imprimante. Les appareils supportant ce type PEUVENT\n implémenter certaines fonctionnalités spécifiques aux imprimantes. Idéalement, l’impression sur des imprimantes prêtes au cloud\n passer par un serveur Cloud Print:
"},{"id":"text-135","type":"text","heading":"","plain_text":"Dans certains cas, un client peut avoir besoin d’envoyer un document localement. Cela peut être nécessaire lorsque le client ne le fait pas\n avoir un identifiant Google ou est incapable de parler au serveur Cloud Print. Dans ce cas, le travail d'impression sera\n être soumis localement à l'imprimante. L’imprimante utilisera à son tour le service Cloud Print pour\n mise en file d'attente et conversion. L’imprimante republiera le travail soumis localement sur le Cloud. Print\n service, puis demandez-le, car il a été envoyé via le cloud. Ce processus fournira une\n expérience utilisateur flexible en termes de service (conversion) et de gestion / suivi des travaux d'impression.","html":"Dans certains cas, un client peut avoir besoin d’envoyer un document localement. Cela peut être nécessaire lorsque le client ne le fait pas\n avoir un identifiant Google ou est incapable de parler au serveur Cloud Print. Dans ce cas, le travail d'impression sera\n être soumis localement à l'imprimante. L’imprimante utilisera à son tour le service Cloud Print pour\n mise en file d'attente et conversion. L’imprimante republiera le travail soumis localement sur le Cloud. Print\n service, puis demandez-le, car il a été envoyé via le cloud. Ce processus fournira une\n expérience utilisateur flexible en termes de service (conversion) et de gestion / suivi des travaux d'impression.
"},{"id":"text-136","type":"text","heading":"","plain_text":"Since the Cloud Print service implements conversion, the printer SHOULD advertise supporting all\n input formats ("*/*") among the list of the supported content types:","html":"Since the Cloud Print service implements conversion, the printer SHOULD advertise supporting all\n input formats ("*/*") among the list of the supported content types:
"},{"id":"text-137","type":"text","heading":"","plain_text":" "version": "1.0",\n "printer": \n "supported_content_type": [\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"*/*\" \n ]","html":""version": "1.0",\n "printer": \n "supported_content_type": [\n "content_type": "image/pwg-raster" ,\n "content_type": "*/*" \n ]
"},{"id":"text-138","type":"text","heading":"","plain_text":"In some cases a completely offline solution is desired. Since printers support a limited number\n of input formats, a client will need to convert documents to a few natively supported printer\n formats.","html":"In some cases a completely offline solution is desired. Since printers support a limited number\n of input formats, a client will need to convert documents to a few natively supported printer\n formats.
"},{"id":"text-139","type":"text","heading":"","plain_text":"This spec REQUIRES all printers to support at least the PWG Raster ("image/pwg-raster") format\n for the offline printing case. A printer may support other formats (for example JPEG) and if a\n client supports it, it may send documents in that format. The printer MUST expose supported types\n through the /capabilities API, for example:","html":"This spec REQUIRES all printers to support at least the PWG Raster ("image/pwg-raster") format\n for the offline printing case. A printer may support other formats (for example JPEG) and if a\n client supports it, it may send documents in that format. The printer MUST expose supported types\n through the /capabilities API, for example:
"},{"id":"text-140","type":"text","heading":"","plain_text":" "version": "1.0",\n "printer": \n "supported_content_type": [\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"image/jpeg\" \n ]","html":""version": "1.0",\n "printer": \n "supported_content_type": [\n "content_type": "image/pwg-raster" ,\n "content_type": "image/jpeg" \n ]
"},{"id":"text-141","type":"text","heading":"","plain_text":"There are two ways a client may initiate printing over the local network.\nSimple printing – client sends the document over the local network to /submitdoc API\n (without specifying the job_id parameter). The submitted document will be printed using default\n print ticket settings and no print job statuses are needed. If the printer ONLY supports this type\n of printing, it MUST advertise ONLY /submitdoc API in the /privet/info API response.","html":"There are two ways a client may initiate printing over the local network.\nSimple printing – client sends the document over the local network to /submitdoc API\n (without specifying the job_id parameter). The submitted document will be printed using default\n print ticket settings and no print job statuses are needed. If the printer ONLY supports this type\n of printing, it MUST advertise ONLY /submitdoc API in the /privet/info API response.
"},{"id":"text-142","type":"text","heading":"","plain_text":""api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n]","html":""api": [\n "/privet/accesstoken",\n "/privet/capabilities",\n "/privet/printer/submitdoc",\n]
"},{"id":"text-143","type":"text","heading":"","plain_text":"Advanced printing – client should first create a print job on the printer by calling the\n /privet/printer/createjob API with a valid CJT job ticket in the request. The printer\n MUST store the print ticket in memory and return a job_id back to the client. Then the client will\n call the /printer/submitdoc API and specify the previously received job_id. At that time\n the printer will start printing. The client will poll the printer for print job status by calling\n le /privet/printer/jobstate API.\nIn a multi-client environment, there is no guarantee how this API is called. It is possible for\n one client to call /createjob between another client’s /createjob->/submitdoc\n calls. To eliminate possible deadlocks and improve usability, we recommended having a small queue\n of pending print jobs on the printer (at least 3-5):","html":"Advanced printing – client should first create a print job on the printer by calling the\n /privet/printer/createjob API with a valid CJT job ticket in the request. The printer\n MUST store the print ticket in memory and return a job_id back to the client. Then the client will\n call the /printer/submitdoc API and specify the previously received job_id. At that time\n the printer will start printing. The client will poll the printer for print job status by calling\n le /privet/printer/jobstate API.\nIn a multi-client environment, there is no guarantee how this API is called. It is possible for\n one client to call /createjob between another client’s /createjob->/submitdoc\n calls. To eliminate possible deadlocks and improve usability, we recommended having a small queue\n of pending print jobs on the printer (at least 3-5):
"},{"id":"text-144","type":"text","heading":"","plain_text":"/createjob takes the first available spot in the queue.\nJob lifetime (in the queue) is at least 5 minutes.\nIf all spots in the queue are taken, then the oldest, non-printing job shall be removed and a\n new one will be placed there.\nIf there is a print job currently printing on the device (simple or advanced printing),\n /submitdoc should return status busy and propose a timeout to retry this print job.\nSi /submitdoc refers to a job that has been removed from the queue (due to\n replacement or timeout), the printer should return an error invalid_print_job et le\n client will retry the process from the /createjob step. The client MUST wait for a\n random timeout period of up to 5 seconds before retrying.","html":"/createjob takes the first available spot in the queue.\nJob lifetime (in the queue) is at least 5 minutes.\nIf all spots in the queue are taken, then the oldest, non-printing job shall be removed and a\n new one will be placed there.\nIf there is a print job currently printing on the device (simple or advanced printing),\n /submitdoc should return status busy and propose a timeout to retry this print job.\nSi /submitdoc refers to a job that has been removed from the queue (due to\n replacement or timeout), the printer should return an error invalid_print_job et le\n client will retry the process from the /createjob step. The client MUST wait for a\n random timeout period of up to 5 seconds before retrying.
"},{"id":"text-145","type":"text","heading":"","plain_text":"If memory constraints prevent storing multiple pending jobs on the device, it is possible to have\n a queue of 1 print job long. It should still follow the same protocol as above. After a job has\n completed or failed with an error, the printer should store information about the job’s\n status for at least 5 minutes. The queue size for storing completed job statuses should be at\n least 10. If there are more job statuses that need to be stored, the oldest one may be removed\n from the queue before the 5 minute timeout.\nRemarque: For now clients will poll for job status. In the future, we may require\n the printer to send TXT DNS notification when ANY print job status has changed.\n5.1. /privet/printer/createjob API\n/privet/printer/createjob API is OPTIONAL (see Simple Printing above). It is an HTTP POST\n request. /privet/printer/createjob API MUST check for a valid "X-Privet-Token" header.\n The device MUST implement this API on "/privet/printer/createjob" url:\nPOST /privet/printer/createjob HTTP/1.1\nWhen receiving /privet/printer/createjob API call, the printer MUST create a new print job ID, store\nthe received print ticket in the CJT format, and return print job id back to the client.\n5.1.1. Input\n/privet/printer/createjob API has no input parameters in URL. The request body should contain the\nprint job ticket data in CJT format.\n5.1.2. Return\n/privet/printer/createjob API returns the following data:","html":"If memory constraints prevent storing multiple pending jobs on the device, it is possible to have\n a queue of 1 print job long. It should still follow the same protocol as above. After a job has\n completed or failed with an error, the printer should store information about the job’s\n status for at least 5 minutes. The queue size for storing completed job statuses should be at\n least 10. If there are more job statuses that need to be stored, the oldest one may be removed\n from the queue before the 5 minute timeout.\nRemarque: For now clients will poll for job status. In the future, we may require\n the printer to send TXT DNS notification when ANY print job status has changed.\n5.1. /privet/printer/createjob API\n/privet/printer/createjob API is OPTIONAL (see Simple Printing above). It is an HTTP POST\n request. /privet/printer/createjob API MUST check for a valid "X-Privet-Token" header.\n The device MUST implement this API on "/privet/printer/createjob" url:\nPOST /privet/printer/createjob HTTP/1.1\nWhen receiving /privet/printer/createjob API call, the printer MUST create a new print job ID, store\nthe received print ticket in the CJT format, and return print job id back to the client.\n5.1.1. Input\n/privet/printer/createjob API has no input parameters in URL. The request body should contain the\nprint job ticket data in CJT format.\n5.1.2. Return\n/privet/printer/createjob API returns the following data:
"},{"id":"text-146","type":"text","heading":"","plain_text":"Value name\nValue type\nLa description","html":"Value name\nValue type\nLa description
"},{"id":"text-147","type":"text","heading":"","plain_text":"job_id\nchaîne\nID of the newly created print job.","html":"job_id\nchaîne\nID of the newly created print job.
"},{"id":"text-148","type":"text","heading":"","plain_text":"expires_in\nint\nNumber of seconds this print job is valid.","html":"expires_in\nint\nNumber of seconds this print job is valid.
"},{"id":"text-149","type":"text","heading":"","plain_text":"Exemple:","html":"Exemple:
"},{"id":"text-150","type":"text","heading":"","plain_text":" "job_id": "123",\n "expires_in": 600","html":""job_id": "123",\n "expires_in": 600
"},{"id":"text-151","type":"text","heading":"","plain_text":"5.1.3. les erreurs\n/privet/printer/createjob API may return the following errors (see Errors section for details):","html":"5.1.3. les erreurs\n/privet/printer/createjob API may return the following errors (see Errors section for details):
"},{"id":"text-152","type":"text","heading":"","plain_text":"Erreur\nLa description","html":"Erreur\nLa description
"},{"id":"text-153","type":"text","heading":"","plain_text":"invalid_ticket\nSubmitted print ticket is invalid.","html":"invalid_ticket\nSubmitted print ticket is invalid.
"},{"id":"text-154","type":"text","heading":"","plain_text":"printer_busy\nPrinter is busy and can’t currently process /createjob. Recommencez\n after timeout.","html":"printer_busy\nPrinter is busy and can’t currently process /createjob. Recommencez\n after timeout.
"},{"id":"text-155","type":"text","heading":"","plain_text":"printer_error\nPrinter is in error state and requires user interaction to fix it.\n Description should contain more detailed explanation (e.g. "Paper jam in Tray 1").","html":"printer_error\nPrinter is in error state and requires user interaction to fix it.\n Description should contain more detailed explanation (e.g. "Paper jam in Tray 1").
"},{"id":"text-156","type":"text","heading":"","plain_text":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request.","html":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request.
"},{"id":"text-157","type":"text","heading":"","plain_text":"If device is not exposing /privet/printer/createjob it MUST return HTTP 404 error. Si\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\n5.2. /privet/printer/submitdoc API\n/privet/printer/submitdoc API is REQUIRED to implement printing over a local network (offline or\nrepost to Cloud Print). It is an HTTP POST request. /privet/printer/submitdoc API MUST check for a\nvalid "X-Privet-Token" header. The device MUST implement this API on\n"/privet/printer/submitdoc" url:\nPOST /privet/printer/submitdoc HTTP/1.1\nWhen receiving the /privet/printer/submitdoc API call, the printer should start printing. If it is\nunable to begin printing, it MUST return the error printer_busy and a recommended timeout period for\nthe client to wait before trying again.\nIf the printer is not able to hold all of the data in its internal buffer, it SHOULD use TCP\n mechanisms to slow down data transfer until it prints a portion of the document, making part of\n the buffer available again. (For example, the printer may set windowsize=0 on TCP layers, which\n will make the client wait.)\nSubmitting a document to the printer may take a significant amount of time. The client should be\n able to check the state of the printer and job (advanced printing) while printing is in progress.\n In order to do that, the printer MUST allow the client to call the /privet/info and\n /privet/printer/jobstate APIs while processing /privet/printer/submitdoc API calls. Il est\n recommended for all clients to start a new thread to execute the /privet/printer/submitdoc API\n call, so that the main thread can use the /privet/info and /privet/printer/jobstate APIs to check\n printer and job states.\nRemarque: Upon completion or abortion of the local print job, it is strongly\n recommended (and will be required in a future version of this spec) to report the final state of\n the job to the /cloudprint/submit interface for accounting and user experience purposes. le\n parameters "printerid", "title", "contentType" and "final_semantic_state" (in\n PrintJobState format) are required, and the parameters "tag" (repeated\n parameter) and "ticket" (the ticket of the job in CloudJobTicket format).\n Note that the provided PrintJobState must actually be final, i.e. its type must be DONE or\n ABORTED, and a cause must be provided in the case that it is ABORTED (see\n JobState for details). Also note that this use of the\n /cloudprint/submit interface to report local print jobs is not mentioned in\n its specification because that section is intended to describe\n the interface's primary use: submitting a print job with the document to print provided in the\n "content" parameter.\n5.2.1. Input\n/privet/printer/submitdoc API has the following input parameters:","html":"If device is not exposing /privet/printer/createjob it MUST return HTTP 404 error. Si\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\n5.2. /privet/printer/submitdoc API\n/privet/printer/submitdoc API is REQUIRED to implement printing over a local network (offline or\nrepost to Cloud Print). It is an HTTP POST request. /privet/printer/submitdoc API MUST check for a\nvalid "X-Privet-Token" header. The device MUST implement this API on\n"/privet/printer/submitdoc" url:\nPOST /privet/printer/submitdoc HTTP/1.1\nWhen receiving the /privet/printer/submitdoc API call, the printer should start printing. If it is\nunable to begin printing, it MUST return the error printer_busy and a recommended timeout period for\nthe client to wait before trying again.\nIf the printer is not able to hold all of the data in its internal buffer, it SHOULD use TCP\n mechanisms to slow down data transfer until it prints a portion of the document, making part of\n the buffer available again. (For example, the printer may set windowsize=0 on TCP layers, which\n will make the client wait.)\nSubmitting a document to the printer may take a significant amount of time. The client should be\n able to check the state of the printer and job (advanced printing) while printing is in progress.\n In order to do that, the printer MUST allow the client to call the /privet/info and\n /privet/printer/jobstate APIs while processing /privet/printer/submitdoc API calls. Il est\n recommended for all clients to start a new thread to execute the /privet/printer/submitdoc API\n call, so that the main thread can use the /privet/info and /privet/printer/jobstate APIs to check\n printer and job states.\nRemarque: Upon completion or abortion of the local print job, it is strongly\n recommended (and will be required in a future version of this spec) to report the final state of\n the job to the /cloudprint/submit interface for accounting and user experience purposes. le\n parameters "printerid", "title", "contentType" and "final_semantic_state" (in\n PrintJobState format) are required, and the parameters "tag" (repeated\n parameter) and "ticket" (the ticket of the job in CloudJobTicket format).\n Note that the provided PrintJobState must actually be final, i.e. its type must be DONE or\n ABORTED, and a cause must be provided in the case that it is ABORTED (see\n JobState for details). Also note that this use of the\n /cloudprint/submit interface to report local print jobs is not mentioned in\n its specification because that section is intended to describe\n the interface's primary use: submitting a print job with the document to print provided in the\n "content" parameter.\n5.2.1. Input\n/privet/printer/submitdoc API has the following input parameters:
"},{"id":"text-158","type":"text","heading":"","plain_text":"Name\nValeur","html":"Name\nValeur
"},{"id":"text-159","type":"text","heading":"","plain_text":"job_id\n(optional) Print job id. May be omitted for simple printing case\n (voir au dessus). Must match the one returned by the printer.","html":"job_id\n(optional) Print job id. May be omitted for simple printing case\n (voir au dessus). Must match the one returned by the printer.
"},{"id":"text-160","type":"text","heading":"","plain_text":"user_name\n(optional) Human readable user name. This is not definitive, and should\n only be used for print job annotations. If job is re-posted to the Cloud Print service this\n string should be attached to the Cloud Print job.","html":"user_name\n(optional) Human readable user name. This is not definitive, and should\n only be used for print job annotations. If job is re-posted to the Cloud Print service this\n string should be attached to the Cloud Print job.
"},{"id":"text-161","type":"text","heading":"","plain_text":"client_name\n(optional) Name of the client application making this request. Pour\n display purposes only. If job is re-posted to the Cloud Print service this string should be\n attached to the Cloud Print job.","html":"client_name\n(optional) Name of the client application making this request. Pour\n display purposes only. If job is re-posted to the Cloud Print service this string should be\n attached to the Cloud Print job.
"},{"id":"text-162","type":"text","heading":"","plain_text":"job_name\n(optional) Name of the print job to be recorded. If job is re-posted to\n the Cloud Print service this string should be attached to the Cloud Print job.","html":"job_name\n(optional) Name of the print job to be recorded. If job is re-posted to\n the Cloud Print service this string should be attached to the Cloud Print job.
"},{"id":"text-163","type":"text","heading":"","plain_text":"offline\n(optional) Could only be "offline=1". In this case printer should\n only try printing offline (no re-post to Cloud Print server).","html":"offline\n(optional) Could only be "offline=1". In this case printer should\n only try printing offline (no re-post to Cloud Print server).
"},{"id":"text-164","type":"text","heading":"","plain_text":"Request body should contain a valid document for printing. "Content-Length" should\n include the correct length of the request. "Content-Type" header should be set to\n document MIME type and match one of the types in the CDD (unless CDD specifies "*/*"). \nClients are HIGHLY recommended to provide a valid user name (or email), a client name and a job\n name with this request. Those fields are only used in UIs to improve user experience.\n5.2.2. Return\n/privet/printer/submitdoc API returns following data:","html":"Request body should contain a valid document for printing. "Content-Length" should\n include the correct length of the request. "Content-Type" header should be set to\n document MIME type and match one of the types in the CDD (unless CDD specifies "*/*"). \nClients are HIGHLY recommended to provide a valid user name (or email), a client name and a job\n name with this request. Those fields are only used in UIs to improve user experience.\n5.2.2. Return\n/privet/printer/submitdoc API returns following data:
"},{"id":"text-165","type":"text","heading":"","plain_text":"Value name\nValue type\nLa description","html":"Value name\nValue type\nLa description
"},{"id":"text-166","type":"text","heading":"","plain_text":"job_id\nchaîne\nID of the newly created print job (simple printing) or\n job_id specified in the request (advanced printing).","html":"job_id\nchaîne\nID of the newly created print job (simple printing) or\n job_id specified in the request (advanced printing).
"},{"id":"text-167","type":"text","heading":"","plain_text":"expires_in\nint\nNumber of seconds this print job is valid.","html":"expires_in\nint\nNumber of seconds this print job is valid.
"},{"id":"text-168","type":"text","heading":"","plain_text":"job_type\nchaîne\nContent-type of the submitted document.","html":"job_type\nchaîne\nContent-type of the submitted document.
"},{"id":"text-169","type":"text","heading":"","plain_text":"job_size\nint 64 bit\nSize of the print data in bytes.","html":"job_size\nint 64 bit\nSize of the print data in bytes.
"},{"id":"text-170","type":"text","heading":"","plain_text":"job_name\nchaîne\n(optional) Same job name as in input (if any).","html":"job_name\nchaîne\n(optional) Same job name as in input (if any).
"},{"id":"text-171","type":"text","heading":"","plain_text":"Exemple:","html":"Exemple:
"},{"id":"text-172","type":"text","heading":"","plain_text":" "job_id": "123",\n "expires_in": 500,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document"","html":""job_id": "123",\n "expires_in": 500,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document"
"},{"id":"text-173","type":"text","heading":"","plain_text":"5.2.3. les erreurs\n/privet/printer/submitdoc API may return the following errors (see Errors section for details):","html":"5.2.3. les erreurs\n/privet/printer/submitdoc API may return the following errors (see Errors section for details):
"},{"id":"text-174","type":"text","heading":"","plain_text":"Erreur\nLa description","html":"Erreur\nLa description
"},{"id":"text-175","type":"text","heading":"","plain_text":"invalid_print_job\nInvalid/expired job id is specified in the request. Retry after\n timeout.","html":"invalid_print_job\nInvalid/expired job id is specified in the request. Retry after\n timeout.
"},{"id":"text-176","type":"text","heading":"","plain_text":"invalid_document_type\nDocument MIME-type is not supported by the printer.","html":"invalid_document_type\nDocument MIME-type is not supported by the printer.
"},{"id":"text-177","type":"text","heading":"","plain_text":"invalid_document\nSubmitted document is invalid.","html":"invalid_document\nSubmitted document is invalid.
"},{"id":"text-178","type":"text","heading":"","plain_text":"document_too_large\nDocument exceeds maximum size allowed.","html":"document_too_large\nDocument exceeds maximum size allowed.
"},{"id":"text-179","type":"text","heading":"","plain_text":"printer_busy\nPrinter is busy and can’t currently process document. Recommencez\n after timeout.","html":"printer_busy\nPrinter is busy and can’t currently process document. Recommencez\n after timeout.
"},{"id":"text-180","type":"text","heading":"","plain_text":"printer_error\nPrinter is in error state and requires user interaction to fix it.\n Description should contain more detailed explanation (e.g. "Paper jam in Tray 1").","html":"printer_error\nPrinter is in error state and requires user interaction to fix it.\n Description should contain more detailed explanation (e.g. "Paper jam in Tray 1").
"},{"id":"text-181","type":"text","heading":"","plain_text":"invalid_params\nInvalid parameters specified in the request. (Unknown parameters\n should be safely ignored for future compatibility)","html":"invalid_params\nInvalid parameters specified in the request. (Unknown parameters\n should be safely ignored for future compatibility)
"},{"id":"text-182","type":"text","heading":"","plain_text":"user_cancel\nUser explicitly cancelled printing process from the device.","html":"user_cancel\nUser explicitly cancelled printing process from the device.
"},{"id":"text-183","type":"text","heading":"","plain_text":"server_error\nPosting document to Cloud Print has failed.","html":"server_error\nPosting document to Cloud Print has failed.
"},{"id":"text-184","type":"text","heading":"","plain_text":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request.","html":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request.
"},{"id":"text-185","type":"text","heading":"","plain_text":"If the device is not exposing /privet/printer/submitdoc, it MUST return HTTP 404 error. Si la\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\nRemarque: /privet/printer/submitdoc API may require special handling on printer\n side (because of the large payload attached). In some cases (depends on the printer HTTP server\n implementation and platform), printer may close socket BEFORE returning HTTP error. In other,\n printer may return 503 error (instead of Privet error). Printers SHOULD try as much as possible to\n return Privet. However, every client implementing Privet specification SHOULD be able to handle\n socket close (no HTTP error) and 503 HTTP error cases for /privet/printer/submitdoc API. Dans ce\n case, client SHOULD handle it as a Privet "printer_busy" error with\n "timeout" set to 15 seconds. To avoid infinite retries, client may stop retrying after\n a reasonable number of attempts (for example, 3).\n5.3. /privet/printer/jobstate API\n/privet/printer/jobstate API is OPTIONAL (see Simple Printing above). It is an HTTP GET request.\n/privet/printer/jobstate API MUST check for a valid "X-Privet-Token" header. The device\nMUST implement this API on "/privet/printer/jobstate" url:\nGET /privet/printer/jobstate HTTP/1.1\nWhen receiving a /privet/printer/jobstate API call, a printer should return the status of the\nrequested print job or invalid_print_job error.\n5.3.1. Input\n/privet/printer/jobstate API has following input parameters:","html":"If the device is not exposing /privet/printer/submitdoc, it MUST return HTTP 404 error. Si la\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\nRemarque: /privet/printer/submitdoc API may require special handling on printer\n side (because of the large payload attached). In some cases (depends on the printer HTTP server\n implementation and platform), printer may close socket BEFORE returning HTTP error. In other,\n printer may return 503 error (instead of Privet error). Printers SHOULD try as much as possible to\n return Privet. However, every client implementing Privet specification SHOULD be able to handle\n socket close (no HTTP error) and 503 HTTP error cases for /privet/printer/submitdoc API. Dans ce\n case, client SHOULD handle it as a Privet "printer_busy" error with\n "timeout" set to 15 seconds. To avoid infinite retries, client may stop retrying after\n a reasonable number of attempts (for example, 3).\n5.3. /privet/printer/jobstate API\n/privet/printer/jobstate API is OPTIONAL (see Simple Printing above). It is an HTTP GET request.\n/privet/printer/jobstate API MUST check for a valid "X-Privet-Token" header. The device\nMUST implement this API on "/privet/printer/jobstate" url:\nGET /privet/printer/jobstate HTTP/1.1\nWhen receiving a /privet/printer/jobstate API call, a printer should return the status of the\nrequested print job or invalid_print_job error.\n5.3.1. Input\n/privet/printer/jobstate API has following input parameters:
"},{"id":"text-186","type":"text","heading":"","plain_text":"Name\nValeur","html":"Name\nValeur
"},{"id":"text-187","type":"text","heading":"","plain_text":"job_id\nPrint job ID to return status for.","html":"job_id\nPrint job ID to return status for.
"},{"id":"text-188","type":"text","heading":"","plain_text":"5.3.2. Return\n/privet/printer/jobstate API returns the following data:","html":"5.3.2. Return\n/privet/printer/jobstate API returns the following data:
"},{"id":"text-189","type":"text","heading":"","plain_text":"Value name\nValue type\nLa description","html":"Value name\nValue type\nLa description
"},{"id":"text-190","type":"text","heading":"","plain_text":"job_id\nchaîne\nPrint job id there status information is for.","html":"job_id\nchaîne\nPrint job id there status information is for.
"},{"id":"text-191","type":"text","heading":"","plain_text":"state\nchaîne\ndraft – print job has been created on the device (no\n /privet/printer/submitdoc calls have been received yet).\n queued – print job has been received and queued, but printing has not started yet.\n in_progress – print job is in the progress of printing.\n stopped – print job has been paused, but can be restarted manually or automatically.\n terminé – print job is done.\n aborted – print job failed.","html":"state\nchaîne\ndraft – print job has been created on the device (no\n /privet/printer/submitdoc calls have been received yet).\n queued – print job has been received and queued, but printing has not started yet.\n in_progress – print job is in the progress of printing.\n stopped – print job has been paused, but can be restarted manually or automatically.\n terminé – print job is done.\n aborted – print job failed.
"},{"id":"text-192","type":"text","heading":"","plain_text":"la description\nchaîne\n(optional) Human readable description of the print job\n status. Should include additional information if statestopped or\n aborted. le semantic_state field usually provides better and more meaningful\n description to the client.","html":"la description\nchaîne\n(optional) Human readable description of the print job\n status. Should include additional information if statestopped or\n aborted. le semantic_state field usually provides better and more meaningful\n description to the client.
"},{"id":"text-193","type":"text","heading":"","plain_text":"expires_in\nint\nNumber of seconds this print job is valid.","html":"expires_in\nint\nNumber of seconds this print job is valid.
"},{"id":"text-194","type":"text","heading":"","plain_text":"job_type\nchaîne\n(optional) Content-type of the submitted document.","html":"job_type\nchaîne\n(optional) Content-type of the submitted document.
"},{"id":"text-195","type":"text","heading":"","plain_text":"job_size\nint 64 bit\n(optional) Size of the print data in bytes.","html":"job_size\nint 64 bit\n(optional) Size of the print data in bytes.
"},{"id":"text-196","type":"text","heading":"","plain_text":"job_name\nchaîne\n(optional) Same job name as in input (if any).","html":"job_name\nchaîne\n(optional) Same job name as in input (if any).
"},{"id":"text-197","type":"text","heading":"","plain_text":"server_job_id\nchaîne\n(optional) ID of the job returned from the server (if\n job has been posted to Cloud Print service). Omitted for offline printing.","html":"server_job_id\nchaîne\n(optional) ID of the job returned from the server (if\n job has been posted to Cloud Print service). Omitted for offline printing.
"},{"id":"text-198","type":"text","heading":"","plain_text":"semantic_state\nJSON\n(optional) Semantic state of the job in\n PrintJobState format.","html":"semantic_state\nJSON\n(optional) Semantic state of the job in\n PrintJobState format.
"},{"id":"text-199","type":"text","heading":"","plain_text":"Example (printing by reporting through Cloud Print):","html":"Example (printing by reporting through Cloud Print):
"},{"id":"text-200","type":"text","heading":"","plain_text":" "job_id": "123",\n "state": "in_progress",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document",\n "server_job_id": "1111-2222-3333-4444"","html":""job_id": "123",\n "state": "in_progress",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document",\n "server_job_id": "1111-2222-3333-4444"
"},{"id":"text-201","type":"text","heading":"","plain_text":"Example (offline printing error):","html":"Example (offline printing error):
"},{"id":"text-202","type":"text","heading":"","plain_text":" "job_id": "123",\n "state": "stopped",\n "description": "Out of paper",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document"","html":""job_id": "123",\n "state": "stopped",\n "description": "Out of paper",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document"
"},{"id":"text-203","type":"text","heading":"","plain_text":"Example (print job aborted by the user):","html":"Example (print job aborted by the user):
"},{"id":"text-204","type":"text","heading":"","plain_text":" "job_id": "123",\n "state": "aborted",\n "description": "User action",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document",\n "semantic_state": \n "version": "1.0",\n "state": \n "type": "ABORTED",\n "user_action_cause": "action_code": "CANCELLED"\n ,\n "pages_printed": 7\n ","html":""job_id": "123",\n "state": "aborted",\n "description": "User action",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document",\n "semantic_state": \n "version": "1.0",\n "state": \n "type": "ABORTED",\n "user_action_cause": "action_code": "CANCELLED"\n ,\n "pages_printed": 7\n
"},{"id":"text-205","type":"text","heading":"","plain_text":"Example (print job stopped due to out of paper). Notice the reference to the device state. le\nclient will need to call the /privet/info API to get more details about the device state:","html":"Example (print job stopped due to out of paper). Notice the reference to the device state. le\nclient will need to call the /privet/info API to get more details about the device state:
"},{"id":"text-206","type":"text","heading":"","plain_text":" "job_id": "123",\n "state": "stopped",\n "description": "Out of paper",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": "123456",\n "job_name": "My PDF document",\n "semantic_state": \n "version": "1.0",\n "state": \n "type": "STOPPED",\n "device_state_cause": "error_code": "INPUT_TRAY"\n ,\n "pages_printed": 7\n ","html":""job_id": "123",\n "state": "stopped",\n "description": "Out of paper",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": "123456",\n "job_name": "My PDF document",\n "semantic_state": \n "version": "1.0",\n "state": \n "type": "STOPPED",\n "device_state_cause": "error_code": "INPUT_TRAY"\n ,\n "pages_printed": 7\n
"},{"id":"text-207","type":"text","heading":"","plain_text":"5.3.3. les erreurs\n/privet/printer/jobstate API may return the following errors (see Errors section for details):","html":"5.3.3. les erreurs\n/privet/printer/jobstate API may return the following errors (see Errors section for details):
"},{"id":"text-208","type":"text","heading":"","plain_text":"Erreur\nLa description","html":"Erreur\nLa description
"},{"id":"text-209","type":"text","heading":"","plain_text":"invalid_print_job\nInvalid/expired job ID is specified in the request.","html":"invalid_print_job\nInvalid/expired job ID is specified in the request.
"},{"id":"text-210","type":"text","heading":"","plain_text":"server_error\nGetting print job status (for print jobs posted to Cloud Print) has\n failed.","html":"server_error\nGetting print job status (for print jobs posted to Cloud Print) has\n failed.
"},{"id":"text-211","type":"text","heading":"","plain_text":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request.","html":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request.
"},{"id":"text-212","type":"text","heading":"","plain_text":"If device is not exposing /privet/printer/jobstate, it MUST return HTTP 404 error. Si la\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\n6. Appendix\n6.1. Default behavior and settings\nThis section will explain the default behavior we expect from ALL Privet-compatible devices.","html":"If device is not exposing /privet/printer/jobstate, it MUST return HTTP 404 error. Si la\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\n6. Appendix\n6.1. Default behavior and settings\nThis section will explain the default behavior we expect from ALL Privet-compatible devices.
"},{"id":"text-213","type":"text","heading":"","plain_text":"Out-of-the-box devices should support only /privet/info et\n /privet/register APIs. All other APIs (e.g. /privet/accesstoken, local printing) should\n be disabled.\nRegistration requires physical interaction with a device.","html":"Out-of-the-box devices should support only /privet/info et\n /privet/register APIs. All other APIs (e.g. /privet/accesstoken, local printing) should\n be disabled.\nRegistration requires physical interaction with a device.
"},{"id":"text-214","type":"text","heading":"","plain_text":"User MUST take a physical action on the device (e.g., pressing a button) to confirm their\n access to the device. \nAfter the user takes the action noted above, the printer should send the\n /cloudprint/register request. It should not send this request until after the action is taken\n (see Sequence Diagram 1).\nIf the device is processing a /privet/register request (for instance, waiting on the action\n above), it must reject all other /privet/register requests. The device MUST return the\n device_busy error in this case.\nThe device should timeout any /register request that does not receive the physical action\n mentioned above within 60 seconds. The device MUST return the confirmation_timeout error in\n this case.\nOptional: Recommended but not required, the following may improve user experience:","html":"User MUST take a physical action on the device (e.g., pressing a button) to confirm their\n access to the device. \nAfter the user takes the action noted above, the printer should send the\n /cloudprint/register request. It should not send this request until after the action is taken\n (see Sequence Diagram 1).\nIf the device is processing a /privet/register request (for instance, waiting on the action\n above), it must reject all other /privet/register requests. The device MUST return the\n device_busy error in this case.\nThe device should timeout any /register request that does not receive the physical action\n mentioned above within 60 seconds. The device MUST return the confirmation_timeout error in\n this case.\nOptional: Recommended but not required, the following may improve user experience:
"},{"id":"text-215","type":"text","heading":"","plain_text":"The printer might flash a light or its screen to indicate that the user needs to take an\n action to confirm registration.\nThe printer might state on its screen that ‘it is being registered to Google Cloud\n Print for user ‘abc@def.com’ – press OK to\n continue’, where abc@def.com is the user\n parameter from the /register API call. This would make it clearer to a user that:","html":"The printer might flash a light or its screen to indicate that the user needs to take an\n action to confirm registration.\nThe printer might state on its screen that ‘it is being registered to Google Cloud\n Print for user ‘abc@def.com’ – press OK to\n continue’, where abc@def.com is the user\n parameter from the /register API call. This would make it clearer to a user that:
"},{"id":"text-216","type":"text","heading":"","plain_text":"it is their registration request that s/he is confirming\nwhat is happening if s/he didn’t trigger the request.","html":"it is their registration request that s/he is confirming\nwhat is happening if s/he didn’t trigger the request.
"},{"id":"text-217","type":"text","heading":"","plain_text":"In addition to a physical action to confirm from the printer (e.g., ‘Press the OK\n button’), a printer may also offer the user a button to cancel the request (e.g.,\n ‘Press Cancel to reject’). This would allow users who did not trigger the\n registration request to cancel it before the 60 second timeout. The device MUST return the\n user_cancel error in this case.","html":"In addition to a physical action to confirm from the printer (e.g., ‘Press the OK\n button’), a printer may also offer the user a button to cancel the request (e.g.,\n ‘Press Cancel to reject’). This would allow users who did not trigger the\n registration request to cancel it before the 60 second timeout. The device MUST return the\n user_cancel error in this case.
"},{"id":"text-218","type":"text","heading":"","plain_text":"Ownership transfers:","html":"Ownership transfers:
"},{"id":"text-219","type":"text","heading":"","plain_text":"The device may be deleted explicitly from the Cloud service.","html":"The device may be deleted explicitly from the Cloud service.
"},{"id":"text-220","type":"text","heading":"","plain_text":"If the device receives success, but no device description as a result of\n /cloudprint/printer (for GCP) call, it MUST revert to default (out-of-the-box) mode. \nIf the device’s credentials no longer work (explicitly because of "invalid\n credentials" response from the server), it MUST revert to default (out-of-the-box)\n mode.","html":"If the device receives success, but no device description as a result of\n /cloudprint/printer (for GCP) call, it MUST revert to default (out-of-the-box) mode. \nIf the device’s credentials no longer work (explicitly because of "invalid\n credentials" response from the server), it MUST revert to default (out-of-the-box)\n mode.
"},{"id":"text-221","type":"text","heading":"","plain_text":"Local factory reset MUST clear device’s credentials and set it to default state.\nOptional: The device may provide a menu item to clear credentials and put it into default\n mode.","html":"Local factory reset MUST clear device’s credentials and set it to default state.\nOptional: The device may provide a menu item to clear credentials and put it into default\n mode.
"},{"id":"text-222","type":"text","heading":"","plain_text":"Devices supporting XMPP notifications MUST include the ability to ping the server. The ping\n timeout MUST be controllable from the server through "local_settings".\nThe device may explicitly ping the server (/cloudprint/printer API for GCP, in addition to\n XMPP pings) no more often than once a day (24 hours) to make sure they are in sync. Il est\n recommended to randomize the check window within 24-32 hour window.\nOptional: For Cloud Print devices, it is recommended but not required to have a manual way\n (button) to allow the user to initiate a check for new print jobs from the device. Some printers\n already have this.\nOptional. Enterprise printers may have an option to disable local discovery completely. Dans\n such case, the device MUST update these local settings on the server. New local settings MUST be\n empty (setting "local_discovery" to "false", means that it can be\n re-enabled from the GCP Service).","html":"Devices supporting XMPP notifications MUST include the ability to ping the server. The ping\n timeout MUST be controllable from the server through "local_settings".\nThe device may explicitly ping the server (/cloudprint/printer API for GCP, in addition to\n XMPP pings) no more often than once a day (24 hours) to make sure they are in sync. Il est\n recommended to randomize the check window within 24-32 hour window.\nOptional: For Cloud Print devices, it is recommended but not required to have a manual way\n (button) to allow the user to initiate a check for new print jobs from the device. Some printers\n already have this.\nOptional. Enterprise printers may have an option to disable local discovery completely. Dans\n such case, the device MUST update these local settings on the server. New local settings MUST be\n empty (setting "local_discovery" to "false", means that it can be\n re-enabled from the GCP Service).
"},{"id":"text-223","type":"text","heading":"","plain_text":"6.1.2 Default Registration Diagram","html":"6.1.2 Default Registration Diagram
"},{"id":"text-224","type":"text","heading":"","plain_text":"6.2. XSSI and XSRF attacks and prevention\nThis section will explain the possibility of XSSI and XSRF attacks on the device and how to protect\nfrom them (including token generation techniques).\nMore details are here:","html":"6.2. XSSI and XSRF attacks and prevention\nThis section will explain the possibility of XSSI and XSRF attacks on the device and how to protect\nfrom them (including token generation techniques).\nMore details are here:
"},{"id":"text-225","type":"text","heading":"","plain_text":"http://googleonlinesecurity.blogspot.com/2011/05/website-security-for-webmasters.html\nNormally, XSSI and XSRF attacks are possible when a site is using cookie authentication\nmechanisms. While Google doesn’t use cookies with their Cloud Print Service, such attacks are\nstill possible. Local network access, by design, implicitly trusts requests.\n6.2.1. XSSI\nIt is possible for a malicious website to guess the IP address and port number of a\nPrivet-compatible device and to try to call the Privet API using "src="http://developers.google.com/inside of a tag:","html":"http://googleonlinesecurity.blogspot.com/2011/05/website-security-for-webmasters.html\nNormally, XSSI and XSRF attacks are possible when a site is using cookie authentication\nmechanisms. While Google doesn’t use cookies with their Cloud Print Service, such attacks are\nstill possible. Local network access, by design, implicitly trusts requests.\n6.2.1. XSSI\nIt is possible for a malicious website to guess the IP address and port number of a\nPrivet-compatible device and to try to call the Privet API using "src="http://developers.google.com/inside of a tag:
"},{"id":"text-226","type":"text","heading":"","plain_text":"Without protection, malicious websites would be able to execute API calls and access results.\nTo prevent this type of attack, ALL Privet API calls MUST require the\n"X-Privet-Token" header in the request. "src="http://developers.google.com/script tags are\nnot able to add headers, effectively guarding against this type of attack.\n6.2.2. XSRF","html":"Without protection, malicious websites would be able to execute API calls and access results.\nTo prevent this type of attack, ALL Privet API calls MUST require the\n"X-Privet-Token" header in the request. "src="http://developers.google.com/script tags are\nnot able to add headers, effectively guarding against this type of attack.\n6.2.2. XSRF
"},{"id":"text-227","type":"text","heading":"","plain_text":"http://en.wikipedia.org/wiki/Cross-site_request_forgery\nIt is possible for a malicious website to guess the IP address and port number of a\nPrivet-compatible device and try to call Privet API using an , forms, or some other\ncross-website loading mechanism. Attackers would not be able to access the results of the request,\nbut if the request would perform an action (e.g. printing), they could trigger it.\nTo prevent this attack, we require the following protection:","html":"http://en.wikipedia.org/wiki/Cross-site_request_forgery\nIt is possible for a malicious website to guess the IP address and port number of a\nPrivet-compatible device and try to call Privet API using an , forms, or some other\ncross-website loading mechanism. Attackers would not be able to access the results of the request,\nbut if the request would perform an action (e.g. printing), they could trigger it.\nTo prevent this attack, we require the following protection:
"},{"id":"text-228","type":"text","heading":"","plain_text":"Leave /privet/info API open to XSRF\n/privet/info API MUST NOT perform any actions on the device\nUse /privet/info API to receive x-privet-token\nAll other APIs MUST check for a valid x-privet-token in "X-Privet-Token" header.\nx-privet-token SHOULD be valid for only 24 hours.","html":"Leave /privet/info API open to XSRF\n/privet/info API MUST NOT perform any actions on the device\nUse /privet/info API to receive x-privet-token\nAll other APIs MUST check for a valid x-privet-token in "X-Privet-Token" header.\nx-privet-token SHOULD be valid for only 24 hours.
"},{"id":"text-229","type":"text","heading":"","plain_text":"Even if an attacker is able to execute the /privet/info API, they would not be able to\nread x-privet-token from the response and therefore would not be able to call any other API.\nIt is strongly recommended to generate the XSRF token using the following algorithm:\nXSRF_token = base64( SHA1(device_secret + DELIMITER + issue_timecounter) + DELIMITER + issue_timecounter )\nXSRF Token Generation Elements:","html":"Even if an attacker is able to execute the /privet/info API, they would not be able to\nread x-privet-token from the response and therefore would not be able to call any other API.\nIt is strongly recommended to generate the XSRF token using the following algorithm:\nXSRF_token = base64( SHA1(device_secret + DELIMITER + issue_timecounter) + DELIMITER + issue_timecounter )\nXSRF Token Generation Elements:
"},{"id":"text-230","type":"text","heading":"","plain_text":"DELIMITER is a special character, usually ‘:’\nissue_timecounter is a number of seconds since some event (epoch for timestamp) or\n device boot time (for CPU counters). issue_timecounter is constantly increasing when\n the device is up and running (see token verification below).\nSHA1 – hash function using SHA1 algorithm\nbase64 – base64 encoding\ndevice_secret – secret specific to the device. Device secret MUST be updated on every\n restart.","html":"DELIMITER is a special character, usually ‘:’\nissue_timecounter is a number of seconds since some event (epoch for timestamp) or\n device boot time (for CPU counters). issue_timecounter is constantly increasing when\n the device is up and running (see token verification below).\nSHA1 – hash function using SHA1 algorithm\nbase64 – base64 encoding\ndevice_secret – secret specific to the device. Device secret MUST be updated on every\n restart.
"},{"id":"text-231","type":"text","heading":"","plain_text":"Recommended ways to generate device secret:","html":"Recommended ways to generate device secret:
"},{"id":"text-232","type":"text","heading":"","plain_text":"Generate a new UUID on every restart\nGenerate a 64 bit random number on every restart","html":"Generate a new UUID on every restart\nGenerate a 64 bit random number on every restart
"},{"id":"text-233","type":"text","heading":"","plain_text":"The device is not required to store all of the XSRF tokens it has issued. When the device needs\n to verify a XSRF token for validity, it should base64-decode the token. Get the\n issue_timecounter from the second half (cleartext), and try to produce SHA1 hash of\n device_secret + DELIMITER + issue_timecounter où issue_timecounter is from\n the token. If the newly generated SHA1 matches the one in the token, device must now check if the\n issue_timecounter is within the validity period from (24 hours) of the current time\n counter. To do so, device takes the current time counter (CPU counter for example) and subtracts\n issue_timecounter à partir de cela. The result MUST be the number of seconds since token\n issue.\nImportant: This is the recommended way to implement XSRF\n protection. Clients of the Privet specification shall not try to understand XSRF token, instead\n they shall treat is as a blackbox. Figure 6.2.3 illustrates a recommended way to implement the\n X-Privet-Token and verification of a typical request.\n6.2.3 X-Privet Token Generation and Verification Sequence Diagram","html":"The device is not required to store all of the XSRF tokens it has issued. When the device needs\n to verify a XSRF token for validity, it should base64-decode the token. Get the\n issue_timecounter from the second half (cleartext), and try to produce SHA1 hash of\n device_secret + DELIMITER + issue_timecounter où issue_timecounter is from\n the token. If the newly generated SHA1 matches the one in the token, device must now check if the\n issue_timecounter is within the validity period from (24 hours) of the current time\n counter. To do so, device takes the current time counter (CPU counter for example) and subtracts\n issue_timecounter à partir de cela. The result MUST be the number of seconds since token\n issue.\nImportant: This is the recommended way to implement XSRF\n protection. Clients of the Privet specification shall not try to understand XSRF token, instead\n they shall treat is as a blackbox. Figure 6.2.3 illustrates a recommended way to implement the\n X-Privet-Token and verification of a typical request.\n6.2.3 X-Privet Token Generation and Verification Sequence Diagram
"},{"id":"text-234","type":"text","heading":"","plain_text":"6.3. Workflow diagrams\nThis section will illustrate a workflow in different cases.\n6.3.1. Printer out of the box workflow","html":"6.3. Workflow diagrams\nThis section will illustrate a workflow in different cases.\n6.3.1. Printer out of the box workflow
"},{"id":"text-235","type":"text","heading":"","plain_text":"6.3.2. Registered printer startup","html":"6.3.2. Registered printer startup
"},{"id":"text-236","type":"text","heading":"","plain_text":"6.3.3 XMPP notifications handling workflow","html":"6.3.3 XMPP notifications handling workflow
"},{"id":"text-237","type":"text","heading":"","plain_text":"6.3.4. Check printer settings workflow","html":"6.3.4. Check printer settings workflow
"},{"id":"text-238","type":"text","heading":"","plain_text":"Click to rate this post!\n \n [Total: 0 Average: 0]","html":"Click to rate this post!\n \n [Total: 0 Average: 0]
"}],"sections":[{"id":"text-1","heading":"Text","content":"Privet est une API de découverte locale d'appareils de nuage utilisée par les services de nuage. Ce document est organisé\n dans les sections suivantes:"},{"id":"text-2","heading":"Text","content":"Introduction: introduction à Privet\nDécouverte: mécanismes de découverte locaux\nAnnonces: annonces de découverte locale\nAPI: API Privet pour les périphériques cloud généraux\nAPI d'imprimante: API Privet utilisées par les imprimantes\nAnnexe: schémas supplémentaires"},{"id":"text-3","heading":"Text","content":"1. Introduction\nLes appareils connectés au cloud présentent de nombreux avantages. Ils peuvent utiliser les services de conversion en ligne, le travail hôte\n file d'attente lorsque l'appareil est hors ligne et accessible de partout dans le monde. Cependant, avec\n nombreux périphériques accessibles par un utilisateur donné dans le cloud, nous devons fournir une méthode permettant de\n appareil le plus proche en fonction de l'emplacement. Le protocole Privet a pour objectif de lier la flexibilité des\n périphériques cloud avec un mécanisme de découverte local approprié, de sorte que les périphériques soient facilement découverts\n nouveaux environnements.\nLes objectifs de ce protocole sont:"},{"id":"text-4","heading":"Text","content":"rendre les périphériques cloud détectables localement\nenregistrer des périphériques cloud avec un service cloud\nassocier les appareils enregistrés à leur représentation dans le nuage\nactiver la fonctionnalité hors ligne\nsimplifier la mise en œuvre pour que les petits appareils puissent l'utiliser"},{"id":"text-5","heading":"Text","content":"Le protocole Privet comprend 2 parties principales: découverte et API. La découverte est utilisée pour trouver le\n périphérique sur le réseau local, et l’API permet d’obtenir des informations sur le périphérique et\n effectuer des actions. Tout au long de ce document, l'appareil désigne un appareil connecté au cloud\n implémenter le protocole Privet.\n2. découverte\nDiscovery est un protocole basé sur zeroconf (mDNS + DNS-SD). Le périphérique DOIT implémenter IPv4 Link-Local\n Adresser. L'appareil DOIT être conforme aux spécifications mDNS et DNS-SD.\nLe dispositif DOIT effectuer la résolution des conflits de noms conformément aux spécifications ci-dessus.\n2.1. type de service\nLa découverte de service DNS utilise le format suivant pour les types de service:\n _applicationprotocol._transportprotocol. Dans le cas du protocole Privet, le service\n type pour DNS-SD devrait être: _privet._tcp\nL'appareil peut également implémenter d'autres types de services. Il est conseillé d'utiliser le même service\n nom d'instance pour tous les types de services implémentés par le périphérique. Par exemple: une imprimante peut\n implémentez les services "Imprimante XYZ._privet._tcp" et "Imprimante XYZ._printer._tcp". Ça va simplifier\n configuration pour l'utilisateur. Cependant, les clients Privet rechercheront uniquement "_privet._tcp".\nEn plus du type de service principal, l’appareil DOIT annoncer les enregistrements PTR pour ses\n sous-type (s) correspondant (voir spéc. DNS-SD: "7.1. Énumération d'instances sélective (sous-types)").\n Le format devrait être le suivant:\n _._sub.privet._tcp\nActuellement, le seul sous-type de périphérique pris en charge est imprimante. Donc, toutes les imprimantes DOIVENT annoncer\n deux enregistrements PTR:"},{"id":"text-6","heading":"Text","content":"_privet._tcp.local.\n_printer._sub._privet._tcp.local."},{"id":"text-7","heading":"Text","content":"2.2. Enregistrement TXT\nle Découverte du service DNS définit des champs pour ajouter des informations facultatives sur un service dans\n les enregistrements TXT. Un enregistrement TXT est constitué de paires clé / valeur. Chaque paire clé / valeur commence à partir du\n longueur octet suivi de 255 octets de texte au maximum. La clé est le texte avant le premier\n Le caractère "=" et la valeur correspond au texte après le premier caractère "="\n jusqu'à la fin. La spécification ne permet aucune valeur dans l'enregistrement, dans ce cas, il n'y aura aucune\n Caractère "=" OU pas de texte après le caractère "=". (Voir spéc. DNS-SD:\n "6.1. Règles générales de format pour les enregistrements DNS TXT" pour le format d'enregistrement DNS TXT et "6.2. DNS-SD TXT\n Taille d'enregistrement "pour la longueur recommandée).\nPrivet exige que le périphérique envoie les paires clé / valeur suivantes dans l'enregistrement TXT. Valeur clé\n les chaînes ne respectent pas la casse, par exemple "CS = online" et "cs = ONLINE" sont\n le même. Les informations contenues dans l'enregistrement TXT DOIVENT être identiques à celles accessibles via l'API / info (voir 4.1.\n Section API).\nIl est recommandé de conserver une taille d’enregistrement TXT inférieure à 512 octets.\n2.2.1. txtvers\nVersion de la structure TXT. txtvers DOIT être le premier enregistrement de la structure TXT. Actuellement\n la seule version supportée est 1.\ntxtvers = 1\n2.2.2. ty\nFournit un nom lisible par l'utilisateur du périphérique. Par exemple:\nty = Modèle d'imprimante Google Cloud Ready XYZ\n2.2.3. note (optionnel)\nFournit un nom lisible par l'utilisateur du périphérique. Par exemple:\nnote = Imprimeur de lobby au 1er étage\nRemarque: Ceci est une clé optionnelle et peut être ignorée. Cependant, si présent, l'utilisateur\n DEVRAIT pouvoir modifier cette valeur. La même description DOIT être utilisée lors de l'enregistrement d'un appareil.\n2.2.4. url\nURL du serveur auquel cet appareil est connecté (protocole compris). Par exemple:\nurl = https: //www.google.com/cloudprint\n2.2.5. type\nListe de sous-types de périphérique pris en charge par ce périphérique, séparés par des virgules. Le format est:\n "type = _subtype1, _subtype2". Actuellement, le seul sous-type de périphérique pris en charge est\n imprimante.\ntype = imprimante\nChaque sous-type répertorié doit être annoncé à l'aide d'un enregistrement PTR correspondant. Pour chaque supporté\n service, il doit y avoir un élément correspondant. Nom du sous-type de service\n (._sub.privet._tcp) devrait être égal au type de périphérique ici.\n2.2.6. identifiant\nReference de l'appareil. Si le périphérique n'a pas encore été enregistré, cette clé doit être présente, mais la valeur\n devrait être vide. Par exemple:"},{"id":"text-8","heading":"Text","content":"id = 11111111-2222-3333-4444-555555555555\n id ="},{"id":"text-9","heading":"Text","content":"2.2.7. cs\nIndique l’état actuel de la connexion du périphérique. Quatre valeurs possibles sont définies dans cette\n spec."},{"id":"text-10","heading":"Text","content":""online" indique que l'appareil est actuellement connecté au cloud.\n"hors ligne" indique que le périphérique est disponible sur le réseau local, mais\n ne peux pas parler au serveur.\n"connexion" indique que le périphérique effectue sa séquence de démarrage et est en train de\n pas encore complètement en ligne.\n"non configuré" indique que l'accès Internet de l'appareil n'a pas été\n configuré pour le moment. Cette valeur n’est pas utilisée actuellement, mais peut être utile dans les futures versions du logiciel.\n spécification."},{"id":"text-11","heading":"Text","content":"Par exemple:"},{"id":"text-12","heading":"Text","content":"cs = en ligne\ncs = hors ligne\ncs = connexion"},{"id":"text-13","heading":"Text","content":"Si le périphérique a été enregistré dans un nuage, il doit vérifier au démarrage la connectivité avec\n serveur pour détecter son état de connexion (par exemple, appeler une API cloud pour obtenir les paramètres du périphérique). le\n L’équipement peut utiliser l’état de la connexion de son canal de notification (XMPP, par exemple) pour signaler cette valeur.\n Les périphériques non enregistrés au démarrage peuvent envoyer un ping à un domaine afin de détecter leur état de connexion (par exemple,\n exemple, effectuez un ping sur www.google.com pour les périphériques d’impression dans le cloud\n3. Annonces\nAu démarrage, à l'arrêt ou au changement d'état du périphérique, le périphérique DOIT exécuter l'étape de l'annonce\n décrit dans la spécification mDNS. Il\n DEVRAIT envoyer l'annonce correspondante au moins deux fois avec un intervalle d'au moins une seconde\n entre eux.\n3.1. Commencez\nAu démarrage de l'appareil, il DOIT exécuter les étapes de vérification et d'annonce décrites dans le manuel mDNS.\n spécification. Les enregistrements SRV, PTR et TXT doivent être envoyés dans ce cas. Il est recommandé de grouper\n tous les enregistrements dans une réponse DNS si possible. Si non, l'ordre suivant est recommandé: SRV,\n PTR, enregistrements TXT.\n3.2. Fermer\nLors de l’arrêt de l’appareil, il DEVRAIT essayer d’en informer toutes les parties intéressées en envoyant un message.\n "Au revoir paquet" avec TTL = 0 (comme décrit dans la documentation de mDNS).\n3.3. Mise à jour\nSi l’une des informations décrites dans TXT a changé, le périphérique DOIT envoyer une mise à jour.\n annonce. Dans ce cas, il suffit d’envoyer le nouvel enregistrement TXT. Par exemple, après un\n appareil est enregistré, il DOIT envoyer une annonce de mise à jour incluant le nouvel identifiant d'appareil.\n4. API\nUne fois qu'un périphérique cloud a été découvert, la communication client est activée avec le périphérique.\n directement sur le réseau local. Toutes les API sont basées sur HTTP 1.1. Les formats de données sont basés sur JSON. API\n les requêtes peuvent être des requêtes GET ou POST.\nChaque demande DOIT contenir un "X-Privet-Token"en-tête. La SEULE demande\n autorisé à avoir un en-tête "X-Privet-Token" vide est la requête / privet / info (note\n l'en-tête DOIT toujours être présent). Si l'en-tête "X-Privet-Token" est manquant, le\n le périphérique DOIT répondre avec l'erreur HTTP 400 suivante:\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\nSi l'en-tête "X-Privet-Token" est vide ou invalide, le périphérique DOIT répondre avec\n "erreur X-Privet-Token non valide" (invalid_x_privet_token, voir la section Erreurs pour plus de détails).\n détails). La seule exception est l'API / info. Pour voir plus d'informations sur pourquoi cela est fait et comment les jetons\n voir Annexe A: Attaques XSSI et XSRF et prévention.\nSi une API demandée n'existe pas ou n'est pas prise en charge, le périphérique DOIT renvoyer une erreur HTTP 404.\n4.1. Disponibilité de l'API\nAvant TOUTE API ne soit exposée (y compris l’API / info), le périphérique DOIT contacter le serveur pour vérifier\n paramètres locaux. Les paramètres locaux DOIVENT être préservés entre\n redémarre. Si le serveur n'est pas disponible, les derniers paramètres locaux connus doivent être utilisés. Si la\n L'appareil n'a pas encore été enregistré, il devrait suivre les paramètres par défaut.\nLes périphériques Cloud Print DOIVENT suivre les étapes ci-dessous pour enregistrer, recevoir et mettre à jour les paramètres locaux.\n4.1.1. enregistrement\nLorsque le périphérique s'inscrit, il DOIT spécifier le paramètre "local_settings", comme suit:"},{"id":"text-14","heading":"Text","content":" "actuel": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": true,\n "printer / conversion_printing_enabled": true,\n "xmpp_timeout_value": 300\n "},{"id":"text-15","heading":"Text","content":"Les paramètres suivants peuvent être définis:"},{"id":"text-16","heading":"Text","content":"Nom de la valeur\nType de valeur\nLa description"},{"id":"text-17","heading":"Text","content":"découverte_locale\nbooléen\nIndique si la fonctionnalité de découverte locale est\n permis. Si "false", toutes les découvertes d'API locale (y compris / info) et DNS-SD doivent être désactivées. Par\n Par défaut, les périphériques nouvellement enregistrés doivent passer "true"."},{"id":"text-18","heading":"Text","content":"access_token_enabled\nbooléen (optionnel)\nIndique si / accesstoken API\n devrait être exposé sur le réseau local. Par défaut devrait être "true"."},{"id":"text-19","heading":"Text","content":"printer / local_printing_enabled\nbooléen (optionnel)\nIndique si local\n la fonctionnalité d’impression (/ printer / createjob, / printer / submitdoc, / printer / jobstate) devrait être\n exposés sur le réseau local. Par défaut devrait être "true"."},{"id":"text-20","heading":"Text","content":"printer / conversion_printing_enabled\nbooléen (optionnel)\nIndique si local\n l'impression peut envoyer le travail au serveur pour la conversion. Cela n’a de sens que lorsque l’impression locale est activée."},{"id":"text-21","heading":"Text","content":"xmpp_timeout_value\nint (facultatif)\nIndique le nombre de secondes entre\n Pingles de canal XMPP. Par défaut, DOIT être 300 (5 minutes) ou plus."},{"id":"text-22","heading":"Text","content":"Important: L’absence de valeur optionnelle indique que le\n la fonctionnalité correspondante est complètement non prise en charge par le périphérique.\n4.1.2. Commencez\nAu démarrage du périphérique, le serveur doit contacter le serveur pour vérifier quelles API sont disponibles pour être exposées dans\n le réseau local. Pour les imprimantes connectées à Cloud Print, elles doivent appeler:\n/ cloudprint / printer? printerid =\nou\n/ cloudprint / list\n/ cloudprint / printer est préférable à / cloudprint / list, mais les deux fonctionneront.\nCette API renvoie les paramètres actuels du périphérique, y compris les paramètres de l'API locale. La réponse du\n Le serveur aura le format suivant:"},{"id":"text-23","heading":"Text","content":""paramètres locaux": \n "actuel": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": true,\n "printer / conversion_printing_enabled": true,\n "xmpp_timeout_value": 300\n ,\n "en attente": \n "local_discovery": true,\n "access_token_enabled": true,\n "printer / local_printing_enabled": false,\n "printer / conversion_printing_enabled": false,\n "xmpp_timeout_value": 500\n "},{"id":"text-24","heading":"Text","content":"L'objet "en cours" indique les paramètres en vigueur pour le moment.\nL'objet "en attente" indique les paramètres à appliquer au périphérique (cet objet\n peut être manquant).\nUne fois que le périphérique voit les paramètres "en attente", il DOIT mettre à jour son état (voir ci-dessous).\n4.1.3. Mise à jour\nSi une mise à jour des paramètres est nécessaire, une notification XMPP sera envoyée au périphérique. La notification\n sera dans le format suivant:\n/mettre à jour les paramètres\nÀ la réception d'une telle notification, le périphérique DOIT interroger le serveur pour obtenir les derniers paramètres.\n Les périphériques Cloud Print DOIVENT utiliser:\n/ cloudprint / printer? printerid =\nUne fois que le périphérique voit la section "en attente" suite à l’API / cloudprint / printer (à\n démarrage ou en raison de la notification), il DOIT mettre à jour son état interne pour se souvenir du nouveau\n paramètres. Il DOIT appeler l'API du serveur pour confirmer les nouveaux paramètres. Pour les imprimantes en nuage, le périphérique\n DOIT appeler / cloudprint / update API et utiliser le paramètre "local_settings" comme pendant\n enregistrement.\nLors de la reconnexion au canal XMPP, le périphérique DOIT appeler / cloudprint / API pour vérifier si\n les paramètres locaux ont été modifiés depuis la dernière fois.\n4.1.3.1. Paramètres locaux en attente\nLe paramètre "local_settings" utilisé par le périphérique pour appeler l'API du serveur NE DOIT JAMAIS contenir\n section "en attente".\n4.1.3.2. Paramètres locaux actuels\nUNIQUEMENT l’appareil peut changer la section "actuelle" des "paramètres locaux".\n Tout le monde changera la section "en attente" et attendra que les modifications soient apportées.\n propagé à la section "en cours" par le périphérique.\n4.1.4. Hors ligne\nLorsqu'il est impossible de contacter le serveur au démarrage, après notification, le périphérique DOIT utiliser le dernier\n paramètres locaux.\n4.1.5. Suppression de l'appareil du service\nSi le périphérique a été supprimé du service (GCP par exemple), une notification XMPP sera envoyée.\n envoyé à l'appareil. La notification sera au format suivant:\n/effacer\nÀ la réception d'une telle notification, le périphérique DOIT se rendre sur le serveur pour vérifier son état. Nuage\n Les périphériques d’impression DOIVENT utiliser:\n/ cloudprint / printer? printerid =\nLe périphérique DOIT recevoir une réponse HTTP réussie avec success = false et aucun périphérique / imprimante.\n la description. Cela signifie que le périphérique a été retiré du serveur et que le périphérique DOIT effacer ses\n informations d’authentification et passer en mode de paramètres d’usine par défaut.\nTOUTE heure à laquelle le périphérique reçoit une réponse indiquant qu'il a été supprimé à la suite de la\n / cloudprint / API (démarrage, notification des paramètres de mise à jour, ping quotidien), elle DOIT supprimer ses\n informations d'identification et aller en mode par défaut.\n4.2. API / privet / info\nL'info API est OBLIGATOIRE et DOIT être implémentée par tous les appareils. C'est une requête HTTP GET pour\n "/ privet / info" url: GET / privet / info HTTP / 1.1\nL'API info renvoie des informations de base sur un périphérique et les fonctionnalités qu'il prend en charge. Cette API\n NE DOIT jamais changer l’état du dispositif ni effectuer aucune action, car il est vulnérable aux attaques XSRF.\n C'est la SEULE API autorisée à avoir un en-tête "X-Privet-Token" vide. Les clients devraient\n API call / privet / info avec en-tête "X-Privet-Token" définie sur X-Privet-Token:\n ""\nL'API info DOIT renvoyer des données cohérentes avec les données disponibles dans l'enregistrement TXT lors de la découverte.\n4.2.1. Contribution\n/ privet / info L'API n'a pas de paramètre d'entrée.\n4.2.2. Revenir\nL'API / privet / info renvoie des informations de base sur le périphérique et les fonctionnalités prises en charge.\nLa colonne TXT indique le champ correspondant dans l’enregistrement DNS-SD TXT."},{"id":"text-25","heading":"Text","content":"Nom de la valeur\nType de valeur\nLa description\nSMS"},{"id":"text-26","heading":"Text","content":"version\nchaîne\nVersion la plus récente (major.minor) de l'API prise en charge, actuellement\n 1,0"},{"id":"text-27","heading":"Text","content":"Nom\nchaîne\nNom lisible par l'homme du périphérique.\nty"},{"id":"text-28","heading":"Text","content":"la description\nchaîne\n(facultatif) Description de l'appareil. DEVRAIT être modifiable par\n utilisateur.\nRemarque"},{"id":"text-29","heading":"Text","content":"url\nchaîne\nURL du serveur avec lequel cet appareil parle. L'URL DOIT inclure\n spécification du protocole, par exemple: https://www.google.com/cloudprint.\nurl"},{"id":"text-30","heading":"Text","content":"type\nliste de chaînes\nListe des types d'appareils pris en charge.\ntype"},{"id":"text-31","heading":"Text","content":"identifiant\nchaîne\nIdentifiant de périphérique, vide si le périphérique n'a pas encore été enregistré.\nidentifiant"},{"id":"text-32","heading":"Text","content":"état_périphérique\nchaîne\nEtat de l'appareil.tourner au ralenti signifie que l'appareil est\n prêtEn traitement signifie que le périphérique est occupé et que les fonctionnalités peuvent être limitées pendant un certain temps\n arrêté signifie que l'appareil ne fonctionne pas et que l'intervention de l'utilisateur est requise"},{"id":"text-33","heading":"Text","content":"état_connexion\nchaîne\nEtat de la connexion au serveur (base_url)\n en ligne – connexion disponible\n hors ligne – pas de connection\n de liaison – effectuer les étapes de démarrage\n pas configuré – la connexion n'a pas encore été configurée\n Un périphérique enregistré peut signaler son état de connexion en fonction de l'état de la notification.\n canal (par exemple, l'état de la connexion XMPP).\ncs"},{"id":"text-34","heading":"Text","content":"fabricant\nchaîne\nNom du fabricant de l'appareil"},{"id":"text-35","heading":"Text","content":"modèle\nchaîne\nModèle de l'appareil"},{"id":"text-36","heading":"Text","content":"numéro de série\nchaîne\nIdentifiant unique de l'appareil. Dans cette spécification, cela DOIT être\n un UUID. (Spec GCP 1.1)\n (facultatif) Nous vous recommandons vivement d’utiliser le même identifiant de numéro de série partout, donc différent.\n les clients peuvent identifier le même appareil. Par exemple, les imprimeurs implémentant IPP peuvent utiliser cette interface série.\n numéro d'identification dans le champ "printer-device-id"."},{"id":"text-37","heading":"Text","content":"firmware\nchaîne\nVersion du firmware de l'appareil"},{"id":"text-38","heading":"Text","content":"la disponibilité\nint\nNombre de secondes à partir du démarrage du périphérique."},{"id":"text-39","heading":"Text","content":"setup_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n instructions d'installation"},{"id":"text-40","heading":"Text","content":"support_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n support, informations FAQ"},{"id":"text-41","heading":"Text","content":"update_url\nchaîne\n(facultatif) URL (protocole compris) de la page avec\n mettre à jour les instructions du firmware"},{"id":"text-42","heading":"Text","content":"x-privet-token\nchaîne\nValeur de la X-Privet-Token en-tête qui a\n à transmettre à toutes les API pour empêcher les attaques XSSI et XSRF. Voir 6.1. pour plus de détails."},{"id":"text-43","heading":"Text","content":"api\ndescription des API\nListe des API prises en charge (décrites ci-dessous)"},{"id":"text-44","heading":"Text","content":"état sémantique\nJSON\n(facultatif) Etat sémantique de l'appareil en\n Format CloudDeviceState."},{"id":"text-45","heading":"Text","content":"api – est une liste JSON contenant la liste des API disponibles via le réseau local. Remarque\n toutes les API ne sont peut-être pas disponibles simultanément sur le réseau local. Par exemple, un nouveau\n L'appareil connecté ne doit supporter que l'API / Register:"},{"id":"text-46","heading":"Text","content":""api": [\n \"/privet/register\",\n]"},{"id":"text-47","heading":"Text","content":"Une fois l'enregistrement de l'appareil terminé, l'appareil DEVRAIT cesser de prendre en charge l'API / register. le\nLe périphérique doit également vérifier auprès du service afin de déterminer quelles API peuvent être exposées sur le serveur local.\nréseau. Par exemple:"},{"id":"text-48","heading":"Text","content":""api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n]"},{"id":"text-49","heading":"Text","content":"Les API suivantes sont disponibles à ce moment:"},{"id":"text-50","heading":"Text","content":"/ privet / register – API pour l'enregistrement de périphérique sur le réseau local. (voir\n / privet / register API pour plus de détails). Cette API DOIT être cachée une fois le périphérique réussi.\n enregistré dans le nuage.\n/ privet / accesstoken – API permettant de demander un jeton d’accès à l’appareil (voir\n / privet / accesstoken API pour plus de détails).\n/ privet / capacités – API permettant de récupérer les capacités du périphérique (voir / privet / capacités\n API pour plus de détails).\n/ privet / printer / * – API spécifique au type de périphérique "imprimante", voir imprimante\n API spécifiques pour plus de détails."},{"id":"text-51","heading":"Text","content":"Voici un exemple de réponse / privet / info. (Notez le manque de l’API / privet / register, car\nce périphérique est déjà enregistré):"},{"id":"text-52","heading":"Text","content":" "version": "1.0",\n "name": "l’imprimante de Gene",\n "description": "Imprimante connectée via un connecteur Chrome",\n "url": "https://www.google.com/cloudprint",\n "type": [\n \"printer\"\n ],\n "id": "11111111-2222-3333-4444-555555555555",\n "device_state": "inactif",\n "connection_state": "en ligne",\n "fabricant": "Google",\n "modèle": "Google Chrome",\n "numéro de série": "1111-22222-33333-4444",\n "firmware": "24.0.1312.52",\n "disponibilité": 600,\n "setup_url": "http://support.google.com/cloudprint/answer/1686197/?hl=fr",\n "support_url": "http://support.google.com/cloudprint/?hl=fr",\n "update_url": "http://support.google.com/cloudprint/?hl=fr",\n "x-privet-token": "AIp06DjQd80yMoGYuGmT_VDAApuBZbInsQ: 1358377509659",\n "api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n ]"},{"id":"text-53","heading":"Text","content":"Voici un exemple de réponse / privet / info pour une imprimante à court d’encre (avis\n état de sémantique):"},{"id":"text-54","heading":"Text","content":"{\n "version": "1.0",\n "name": "l’imprimante de Gene",\n "description": "Imprimante connectée via un connecteur Chrome",\n "url": "https://www.google.com/cloudprint",\n "type": [\n \"printer\"\n ],\n "id": "11111111-2222-3333-4444-555555555555",\n "device_state": "stoppé",\n "connection_state": "en ligne",\n "fabricant": "Google",\n "modèle": "Google Chrome",\n "numéro de série": "1111-22222-33333-4444",\n "firmware": "24.0.1312.52",\n "disponibilité": 600,\n "setup_url": "http://support.google.com/cloudprint/answer/1686197/?hl=fr",\n "support_url": "http://support.google.com/cloudprint/?hl=fr",\n "update_url": "http://support.google.com/cloudprint/?hl=fr",\n "x-privet-token": "AIp06DjQd80yMoGYuGmT_VDAApuBZbInsQ: 1358377509659",\n "api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n ],\n "état sémantique": \n "version": "1.0",\n "imprimante": \n "state": "STOPPED",\n "marker_state": \n "article": [\n \n \"vendor_id\": \"ink\",\n \"state\": \"EXHAUSTED\",\n \"level_percent\": 0\n \n ]\n \n \n \n}"},{"id":"text-55","heading":"Text","content":"4.2.3. les erreurs\n/ privet / info API devrait SEULEMENT renvoyer une erreur si X-Privet-Token l'en-tête est manquant. Il\n DOIT être une erreur HTTP 400:\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\n4.3. / privet / register API\n/ privet / register est facultative. C'est une requête HTTP POST. / privet / register API DOIT vérifier\n pour une validité X-Privet-Token entête. Le périphérique DOIT implémenter cette API sur\n "/ privet / register" url:"},{"id":"text-56","heading":"Text","content":"POST /privet/register?action=start&user=user@domain.com HTTP / 1.1\nPOST /privet/register?action=complete&user=user@domain.com HTTP / 1.1"},{"id":"text-57","heading":"Text","content":"L’appareil doit exposer l’API / privet / register UNIQUEMENT lorsqu’il autorise l’enregistrement anonyme à la\n moment. Par exemple:"},{"id":"text-58","heading":"Text","content":"Lorsque le périphérique est allumé (ou après avoir cliqué sur un bouton spécial du périphérique) et n’a pas\n été enregistré, il devrait exposer l’API / privet / register pour permettre à un utilisateur du répertoire local\n réseau pour réclamer l’imprimante.\nUne fois l’enregistrement terminé, le périphérique doit cesser d’exposer l’API / privet / register à\n empêcher un autre utilisateur du réseau local de récupérer le périphérique.\nCertains appareils peuvent avoir différentes façons d’enregistrer des appareils et ne doivent pas exposer le\n / privet / register à tous (par exemple, le connecteur Chrome Cloud Print)."},{"id":"text-59","heading":"Text","content":"Le processus d’enregistrement se déroule en 3 étapes (voir Enregistrement anonyme pour Cloud Print)."},{"id":"text-60","heading":"Text","content":"Lancer le processus d'inscription anonyme.\nUn client initie ce processus en appelant l'API / privet / register. L'appareil peut attendre\n confirmation de l'utilisateur à ce moment.\nObtenez le jeton de réclamation."},{"id":"text-61","heading":"Text","content":"Le client interroge pour savoir quand l'appareil est prêt à continuer. Une fois que l'appareil est prêt, il\n envoie une demande au serveur pour récupérer le jeton d'enregistrement et l'URL d'inscription. Jeton reçu\n et URL DEVRAIT être retourné au client. Au cours de cette étape, si le périphérique reçoit un autre appel pour\n initialiser l'enregistrement, il devrait:"},{"id":"text-62","heading":"Text","content":"Si c’est le même utilisateur qui a commencé l’enregistrement, supprimez toutes les données précédentes (le cas échéant) et démarrez le système.\n un nouveau processus d'inscription.\nS'il s'agit d'un utilisateur différent, retourne une erreur device_busy et un délai d'attente de 30 secondes."},{"id":"text-63","heading":"Text","content":"Processus d'inscription complet.\nUne fois que le client a réclamé le périphérique, il doit lui notifier son achèvement.\n enregistrement. Une fois le processus d'enregistrement terminé, l'appareil doit envoyer une mise à jour.\n annonce, y compris l'ID de périphérique nouvellement acquis.\nRemarque: lorsque le périphérique traite un appel d'API / privet / register, aucune autre API / privet / register\n les appels peuvent être traités simultanément. Le périphérique DOIT retourner l'erreur device_busy et 30 secondes\n temps libre.\nLa confirmation de l'utilisateur pour l'enregistrement sur l'appareil est fortement recommandée. Si mis en œuvre, le\n le périphérique DOIT attendre la confirmation de l'utilisateur APRÈS qu'il reçoive un / privet / register? action = start API\n appel. Le client appellera / privet / register? Action = getClaimToken pour savoir quand\n la confirmation de l'utilisateur est terminée et le jeton de réclamation est disponible. Si l'utilisateur annule son inscription le\n l'appareil (par exemple, appuie sur le bouton Annuler), l'erreur user_cancel DOIT être renvoyée. Si l'utilisateur\n l’enregistrement n’a pas été confirmé dans un certain délai, l’erreur confirmation_timeout DOIT être\n revenu. Voir la section des valeurs par défaut pour plus de détails.\n4.3.1. Contribution\nL'API / privet / register a les paramètres d'entrée suivants:"},{"id":"text-64","heading":"Text","content":"Nom\nValeur"},{"id":"text-65","heading":"Text","content":"action\nPeut être l'un des suivants:\n début – pour commencer le processus d'inscription\n getClaimToken – récupérer le jeton de réclamation pour le périphérique\n Annuler – annuler le processus d'inscription\n Achevée – terminer le processus d'inscription"},{"id":"text-66","heading":"Text","content":"utilisateur\nEmail de l'utilisateur qui réclamera cet appareil."},{"id":"text-67","heading":"Text","content":"Le périphérique DOIT vérifier que l’adresse électronique de toutes les actions (start, getClaimToken, annuler,\n complète) correspond.\n4.3.2. Revenir\nL'API / privet / register renvoie les données suivantes:"},{"id":"text-68","heading":"Text","content":"Nom de la valeur\nType de valeur\nLa description"},{"id":"text-69","heading":"Text","content":"action\nchaîne\nMême action que dans le paramètre d'entrée."},{"id":"text-70","heading":"Text","content":"utilisateur\nchaîne (optionnel)\nMême utilisateur que dans le paramètre d'entrée (peut être manquant, si\n omis dans l'entrée)."},{"id":"text-71","heading":"Text","content":"jeton\nchaîne (optionnel)\nJeton d'inscription (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler")."},{"id":"text-72","heading":"Text","content":"claim_url\nchaîne (optionnel)\nURL d'enregistrement (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler"). Pour les imprimantes en nuage, il faut\n être "complete_invite_url" reçu du serveur."},{"id":"text-73","heading":"Text","content":"automation_claim_url\nchaîne (optionnel)\nURL d'enregistrement (obligatoire pour\n Réponse "getClaimToken", omise pour "démarrer", "complète", "annuler"). Pour les imprimantes en nuage, il faut\n être "automatic_invite_url" reçu du serveur."},{"id":"text-74","heading":"Text","content":"Reference de l'appareil\nchaîne (optionnel)\nNouvel identifiant d'appareil (omis pour la réponse "start",\n obligatoire pour "complet")."},{"id":"text-75","heading":"Text","content":"Le périphérique DOIT retourner son identifiant de périphérique dans la réponse de l'API / privet / info UNIQUEMENT après l'enregistrement.\n Achevée.\nExemple 1:"},{"id":"text-76","heading":"Text","content":" "action": "start",\n "utilisateur": "utilisateur@domaine.com","},{"id":"text-77","heading":"Text","content":"Exemple 2:"},{"id":"text-78","heading":"Text","content":" "action": "getClaimToken",\n "utilisateur": "utilisateur@domaine.com",\n "jeton": "AAA111222333444555666777",\n "claim_url": "https://domain.com/SoMeUrL","},{"id":"text-79","heading":"Text","content":"Exemple 3:"},{"id":"text-80","heading":"Text","content":" "action": "complet",\n "utilisateur": "utilisateur@domaine.com",\n "device_id": "11111111-2222-3333-4444-555555555555","},{"id":"text-81","heading":"Text","content":"4.3.3. les erreurs\nL'API / privet / register peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):"},{"id":"text-82","heading":"Text","content":"Erreur\nLa description"},{"id":"text-83","heading":"Text","content":"device_busy\nLe périphérique est occupé et ne peut pas effectuer l’action demandée. Recommencez\n après timeout."},{"id":"text-84","heading":"Text","content":"waiting_user_action\nEn réponse à "getClaimToken", cette erreur indique que le\n le périphérique est toujours en attente de confirmation de l'utilisateur, et la requête "getClaimToken" doit être réessayée après\n temps libre."},{"id":"text-85","heading":"Text","content":"user_cancel\nL'utilisateur a explicitement annulé le processus d'inscription depuis l'appareil."},{"id":"text-86","heading":"Text","content":"confirmation_timeout\nLa confirmation de l'utilisateur expire."},{"id":"text-87","heading":"Text","content":"invalide_action\nUne action invalide est appelée. Par exemple, si le client appelé\n action = terminé avant d'appeler action = start et action = getClaimToken."},{"id":"text-88","heading":"Text","content":"parent_invalide\nParamètres non valides spécifiés dans la demande. (Paramètres inconnus\n doit être ignoré pour une compatibilité future). Par exemple, renvoyez ceci si le client\n appelé action = inconnu ou utilisateur =."},{"id":"text-89","heading":"Text","content":"device_config_error\nLa date / heure (ou certains autres paramètres) est incorrecte sur l'appareil\n côté. L'utilisateur doit aller (sur le site Web interne du périphérique) et configurer les paramètres du périphérique."},{"id":"text-90","heading":"Text","content":"hors ligne\nL’appareil est actuellement hors ligne et ne peut pas communiquer avec le serveur."},{"id":"text-91","heading":"Text","content":"erreur du serveur\nErreur du serveur pendant le processus d'inscription."},{"id":"text-92","heading":"Text","content":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la requête."},{"id":"text-93","heading":"Text","content":"Le périphérique DOIT cesser d’exposer l’API / privet / register une fois l’enregistrement effectué avec succès.\n terminé. Si le périphérique n'expose pas l'API / privet / register, il DOIT renvoyer l'erreur HTTP 404.\n Par conséquent, si un périphérique est déjà enregistré, l'appel de cette API DOIT renvoyer 404. Si le\n L'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer l'erreur HTTP 400.\n4.4. / privet / accesstoken API\n/ privet / accesstoken API est FACULTATIF. C'est une requête HTTP GET. / privet / accesstoken API DOIT vérifier\npour un en-tête "X-Privet-Token" valide. Le périphérique DOIT implémenter cette API sur le\n"/ privet / accesstoken" url:\nGET / privet / accesstoken HTTP / 1.1\nLorsque le périphérique reçoit l'appel de l'API / accesstoken, il doit appeler le serveur pour récupérer le\n jeton d'accès pour l'utilisateur donné et renvoyer le jeton au client. Le client utilisera ensuite le\n jeton d'accès pour accéder à cet appareil via le cloud.\nLes périphériques Cloud Print DOIVENT appeler l'API suivante:\n/ cloudprint / proximitétoken\net passez les paramètres "printerid =" et "user" du local\nAPI. En cas de succès, la réponse du serveur contiendra l'objet suivant:"},{"id":"text-94","heading":"Text","content":""proximité_token": \n "utilisateur": "utilisateur@domaine.com",\n "jeton": "AAA111222333444555666777",\n "expires_in": 600"},{"id":"text-95","heading":"Text","content":"Les périphériques Cloud Print DOIVENT transmettre la valeur de l’objet "proximité_token" dans la réponse.\naux appels d’API locaux / privet / accesstoken. Il est plus avantageux (à l’avenir) que l’appareil puisse\npasse TOUS les paramètres (y compris ceux qui ne sont pas décrits dans cette spécification).\n4.4.1. Contribution\nL'API / privet / accesstoken a les paramètres d'entrée suivants:"},{"id":"text-96","heading":"Text","content":"Nom\nValeur"},{"id":"text-97","heading":"Text","content":"utilisateur\nEmail de l'utilisateur qui a eu l'intention d'utiliser ce jeton d'accès. Peut être vide dans le\n demande."},{"id":"text-98","heading":"Text","content":"4.4.2. Revenir\n/ privet / accesstoken L'API renvoie les données suivantes:"},{"id":"text-99","heading":"Text","content":"Nom de la valeur\nType de valeur\nLa description"},{"id":"text-100","heading":"Text","content":"jeton\nchaîne\nJeton d'accès renvoyé par le serveur"},{"id":"text-101","heading":"Text","content":"utilisateur\nchaîne\nMême utilisateur que dans le paramètre d'entrée."},{"id":"text-102","heading":"Text","content":"expire dans\nint\nNombre de secondes jusqu'à l'expiration de ce jeton. Reçu de\n le serveur et passé dans cette réponse."},{"id":"text-103","heading":"Text","content":"Exemple:"},{"id":"text-104","heading":"Text","content":" "jeton": "AAA111222333444555666777",\n "utilisateur": "utilisateur@domaine.com",\n "expires_in": 600"},{"id":"text-105","heading":"Text","content":"4.4.3. les erreurs\nL'API / privet / accesstoken peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):"},{"id":"text-106","heading":"Text","content":"Erreur\nLa description"},{"id":"text-107","heading":"Text","content":"hors ligne\nL'appareil est actuellement hors ligne et ne peut pas parler au serveur."},{"id":"text-108","heading":"Text","content":"accès refusé\nDroits insuffisants. Accès refusé. L'appareil doit renvoyer cette\n erreur lorsque la demande a été explicitement refusée par le serveur."},{"id":"text-109","heading":"Text","content":"parent_invalide\nParamètres non valides spécifiés dans la demande. (Paramètres inconnus\n doit être ignoré pour une compatibilité future). Par exemple, si le client appelé\n / accesstoken? user = ou / accesstoken."},{"id":"text-110","heading":"Text","content":"erreur du serveur\nErreur du serveur."},{"id":"text-111","heading":"Text","content":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la demande."},{"id":"text-112","heading":"Text","content":"Si le périphérique n'expose pas l'API / privet / accesstoken, il DOIT renvoyer l'erreur HTTP 404. Si la\n L'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer l'erreur HTTP 400.\n4.5 / privet / API de capacités\n/ privet / features est facultatif. C'est une requête HTTP GET. / privet / functions API DOIT vérifier\npour un en-tête "X-Privet-Token" valide. Le périphérique DOIT implémenter cette API sur\nURL "/ privet / capacités":\nGET / privet / capacités HTTP / 1.1\nLorsque le périphérique reçoit / appel de l'API de fonctionnalités, si le périphérique est capable, il DEVRAIT contacter\nle serveur pour obtenir des capacités mises à jour. Par exemple, si une imprimante prend en charge la publication d'un travail d'impression\n(reçu localement) à travers le service Cloud Print, il devrait renvoyer les fonctionnalités que le\nLe service d'impression en nuage reviendrait. Cloud Print dans ce cas peut altérer l'imprimante d'origine\nfonctions en ajoutant de nouvelles fonctionnalités avant d’envoyer le travail à l’imprimante. Le plus\nLe cas courant est une liste de types de documents pris en charge. Si l'imprimante est hors ligne, elle devrait renvoyer\ntypes de documents qu'il prend en charge. Cependant, si l'imprimante est en ligne et enregistrée auprès de Cloud Print it\nDOIT retourner "* / *" parmi les types pris en charge. Le service Cloud Print sera exécuté\nla conversion nécessaire dans ce cas. Pour l’impression hors ligne, l’imprimante DOIT prendre en charge au moins la\nformat "image / pwg-raster".\n4.5.1. Contribution\nL'API / privet / functions a les paramètres d'entrée suivants:"},{"id":"text-113","heading":"Text","content":"Nom\nValeur"},{"id":"text-114","heading":"Text","content":"hors ligne\n(facultatif) Ne peut être que "hors ligne = 1". Dans ce cas, l'appareil doit retourner\n capacités pour une utilisation hors connexion (si elles sont différentes des capacités "en ligne")."},{"id":"text-115","heading":"Text","content":"4.5.2. Revenir\nL'API / privet / features renvoie les fonctionnalités de périphérique dans le fichier JSON CDD (Cloud Device Description)\nformat (voir le document CDD pour plus de détails). Les imprimantes au minimum DOIVENT renvoyer une liste des types pris en charge\nici. Par exemple, une imprimante Cloud Ready actuellement en ligne peut renvoyer quelque chose comme ceci (à\nle minimum):"},{"id":"text-116","heading":"Text","content":" "version": "1.0",\n "imprimante": \n "supported_content_type": [\n \n \"content_type\": \"application/pdf\",\n \"min_version\": \"1.4\"\n ,\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"image/jpeg\" ,\n \"content_type\": \"*/*\" \n ]"},{"id":"text-117","heading":"Text","content":"et quand il est déconnecté du serveur, il peut retourner:"},{"id":"text-118","heading":"Text","content":" "version": "1.0",\n "imprimante": \n "supported_content_type": [\n \n \"content_type\": \"application/pdf\",\n \"min_version\": \"1.4\"\n ,\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"image/jpeg\" \n ]"},{"id":"text-119","heading":"Text","content":"Remarque: Les imprimantes expriment la priorité du type de contenu pris en charge en utilisant la commande. Pour\n Par exemple, dans les exemples ci-dessus, l’imprimante indique qu’elle préfère les données "application / pdf" à\n "image / pwg-raster" et "image / jpeg". Les clients doivent respecter les priorités des imprimantes si possible\n (voir le document CDD pour plus de détails).\n4.5.3. les erreurs\nL'API / privet / features peut renvoyer les erreurs suivantes (voir la section Erreurs pour plus de détails):"},{"id":"text-120","heading":"Text","content":"Erreur\nLa description"},{"id":"text-121","heading":"Text","content":"invalid_x_privet_token\nX-Privet-Token est invalide ou vide dans la requête."},{"id":"text-122","heading":"Text","content":"Si le périphérique n'expose pas l'API / privet / features, il DOIT renvoyer HTTP 404.\n Erreur. Si l'en-tête X-Privet-Token est manquant, le périphérique DOIT renvoyer une erreur HTTP 400.\n4.6. les erreurs\nLes erreurs sont renvoyées par les API ci-dessus au format suivant:"},{"id":"text-123","heading":"Text","content":"Nom de la valeur\nType de valeur\nLa description"},{"id":"text-124","heading":"Text","content":"Erreur\nchaîne\nType d'erreur (défini par API)"},{"id":"text-125","heading":"Text","content":"la description\nchaîne (optionnel)\nDescription lisible par l'homme de l'erreur."},{"id":"text-126","heading":"Text","content":"server_api\nchaîne (optionnel)\nEn cas d'erreur de serveur, ce champ contient\n l'API du serveur qui a échoué."},{"id":"text-127","heading":"Text","content":"code_serveur\nint (facultatif)\nEn cas d'erreur de serveur, ce champ contient\n ce code d'erreur que le serveur a renvoyé."},{"id":"text-128","heading":"Text","content":"code_http_serveur\nint (facultatif)\nEn cas d'erreur HTTP du serveur, ce champ\n contient le code d'erreur HTTP serveur renvoyé."},{"id":"text-129","heading":"Text","content":"temps libre\nint (facultatif)\nNombre de secondes que le client attend avant\n nouvelle tentative (pour les erreurs récupérables uniquement). Le client DOIT randomiser le délai d’expiration réel de cette valeur sur\n une valeur de + 20%."},{"id":"text-130","heading":"Text","content":"Toutes les API DOIVENT renvoyer une erreur HTTP 400 si l'en-tête X-Privet-Token est manquant.\nHTTP / 1.1 400 En-tête X-Privet-Token manquant.\nExemple 1:"},{"id":"text-131","heading":"Text","content":" "erreur": "erreur_serveur",\n "description": "Service indisponible",\n "server_api": "/ submit",\n "code_http_serveur": 503"},{"id":"text-132","heading":"Text","content":"Exemple 2:"},{"id":"text-133","heading":"Text","content":" "error": "printer_busy",\n "description": "L'imprimante est en train d'imprimer un autre travail",\n "timeout": 15"},{"id":"text-134","heading":"Text","content":"5. API d'imprimante\nL'un des types de périphérique pris en charge par ce protocole est le type imprimante. Les appareils supportant ce type PEUVENT\n implémenter certaines fonctionnalités spécifiques aux imprimantes. Idéalement, l’impression sur des imprimantes prêtes au cloud\n passer par un serveur Cloud Print:"},{"id":"text-135","heading":"Text","content":"Dans certains cas, un client peut avoir besoin d’envoyer un document localement. Cela peut être nécessaire lorsque le client ne le fait pas\n avoir un identifiant Google ou est incapable de parler au serveur Cloud Print. Dans ce cas, le travail d'impression sera\n être soumis localement à l'imprimante. L’imprimante utilisera à son tour le service Cloud Print pour\n mise en file d'attente et conversion. L’imprimante republiera le travail soumis localement sur le Cloud. Print\n service, puis demandez-le, car il a été envoyé via le cloud. Ce processus fournira une\n expérience utilisateur flexible en termes de service (conversion) et de gestion / suivi des travaux d'impression."},{"id":"text-136","heading":"Text","content":"Since the Cloud Print service implements conversion, the printer SHOULD advertise supporting all\n input formats ("*/*") among the list of the supported content types:"},{"id":"text-137","heading":"Text","content":" "version": "1.0",\n "printer": \n "supported_content_type": [\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"*/*\" \n ]"},{"id":"text-138","heading":"Text","content":"In some cases a completely offline solution is desired. Since printers support a limited number\n of input formats, a client will need to convert documents to a few natively supported printer\n formats."},{"id":"text-139","heading":"Text","content":"This spec REQUIRES all printers to support at least the PWG Raster ("image/pwg-raster") format\n for the offline printing case. A printer may support other formats (for example JPEG) and if a\n client supports it, it may send documents in that format. The printer MUST expose supported types\n through the /capabilities API, for example:"},{"id":"text-140","heading":"Text","content":" "version": "1.0",\n "printer": \n "supported_content_type": [\n \"content_type\": \"image/pwg-raster\" ,\n \"content_type\": \"image/jpeg\" \n ]"},{"id":"text-141","heading":"Text","content":"There are two ways a client may initiate printing over the local network.\nSimple printing – client sends the document over the local network to /submitdoc API\n (without specifying the job_id parameter). The submitted document will be printed using default\n print ticket settings and no print job statuses are needed. If the printer ONLY supports this type\n of printing, it MUST advertise ONLY /submitdoc API in the /privet/info API response."},{"id":"text-142","heading":"Text","content":""api": [\n \"/privet/accesstoken\",\n \"/privet/capabilities\",\n \"/privet/printer/submitdoc\",\n]"},{"id":"text-143","heading":"Text","content":"Advanced printing – client should first create a print job on the printer by calling the\n /privet/printer/createjob API with a valid CJT job ticket in the request. The printer\n MUST store the print ticket in memory and return a job_id back to the client. Then the client will\n call the /printer/submitdoc API and specify the previously received job_id. At that time\n the printer will start printing. The client will poll the printer for print job status by calling\n le /privet/printer/jobstate API.\nIn a multi-client environment, there is no guarantee how this API is called. It is possible for\n one client to call /createjob between another client’s /createjob->/submitdoc\n calls. To eliminate possible deadlocks and improve usability, we recommended having a small queue\n of pending print jobs on the printer (at least 3-5):"},{"id":"text-144","heading":"Text","content":"/createjob takes the first available spot in the queue.\nJob lifetime (in the queue) is at least 5 minutes.\nIf all spots in the queue are taken, then the oldest, non-printing job shall be removed and a\n new one will be placed there.\nIf there is a print job currently printing on the device (simple or advanced printing),\n /submitdoc should return status busy and propose a timeout to retry this print job.\nSi /submitdoc refers to a job that has been removed from the queue (due to\n replacement or timeout), the printer should return an error invalid_print_job et le\n client will retry the process from the /createjob step. The client MUST wait for a\n random timeout period of up to 5 seconds before retrying."},{"id":"text-145","heading":"Text","content":"If memory constraints prevent storing multiple pending jobs on the device, it is possible to have\n a queue of 1 print job long. It should still follow the same protocol as above. After a job has\n completed or failed with an error, the printer should store information about the job’s\n status for at least 5 minutes. The queue size for storing completed job statuses should be at\n least 10. If there are more job statuses that need to be stored, the oldest one may be removed\n from the queue before the 5 minute timeout.\nRemarque: For now clients will poll for job status. In the future, we may require\n the printer to send TXT DNS notification when ANY print job status has changed.\n5.1. /privet/printer/createjob API\n/privet/printer/createjob API is OPTIONAL (see Simple Printing above). It is an HTTP POST\n request. /privet/printer/createjob API MUST check for a valid "X-Privet-Token" header.\n The device MUST implement this API on "/privet/printer/createjob" url:\nPOST /privet/printer/createjob HTTP/1.1\nWhen receiving /privet/printer/createjob API call, the printer MUST create a new print job ID, store\nthe received print ticket in the CJT format, and return print job id back to the client.\n5.1.1. Input\n/privet/printer/createjob API has no input parameters in URL. The request body should contain the\nprint job ticket data in CJT format.\n5.1.2. Return\n/privet/printer/createjob API returns the following data:"},{"id":"text-146","heading":"Text","content":"Value name\nValue type\nLa description"},{"id":"text-147","heading":"Text","content":"job_id\nchaîne\nID of the newly created print job."},{"id":"text-148","heading":"Text","content":"expires_in\nint\nNumber of seconds this print job is valid."},{"id":"text-149","heading":"Text","content":"Exemple:"},{"id":"text-150","heading":"Text","content":" "job_id": "123",\n "expires_in": 600"},{"id":"text-151","heading":"Text","content":"5.1.3. les erreurs\n/privet/printer/createjob API may return the following errors (see Errors section for details):"},{"id":"text-152","heading":"Text","content":"Erreur\nLa description"},{"id":"text-153","heading":"Text","content":"invalid_ticket\nSubmitted print ticket is invalid."},{"id":"text-154","heading":"Text","content":"printer_busy\nPrinter is busy and can’t currently process /createjob. Recommencez\n after timeout."},{"id":"text-155","heading":"Text","content":"printer_error\nPrinter is in error state and requires user interaction to fix it.\n Description should contain more detailed explanation (e.g. "Paper jam in Tray 1")."},{"id":"text-156","heading":"Text","content":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request."},{"id":"text-157","heading":"Text","content":"If device is not exposing /privet/printer/createjob it MUST return HTTP 404 error. Si\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\n5.2. /privet/printer/submitdoc API\n/privet/printer/submitdoc API is REQUIRED to implement printing over a local network (offline or\nrepost to Cloud Print). It is an HTTP POST request. /privet/printer/submitdoc API MUST check for a\nvalid "X-Privet-Token" header. The device MUST implement this API on\n"/privet/printer/submitdoc" url:\nPOST /privet/printer/submitdoc HTTP/1.1\nWhen receiving the /privet/printer/submitdoc API call, the printer should start printing. If it is\nunable to begin printing, it MUST return the error printer_busy and a recommended timeout period for\nthe client to wait before trying again.\nIf the printer is not able to hold all of the data in its internal buffer, it SHOULD use TCP\n mechanisms to slow down data transfer until it prints a portion of the document, making part of\n the buffer available again. (For example, the printer may set windowsize=0 on TCP layers, which\n will make the client wait.)\nSubmitting a document to the printer may take a significant amount of time. The client should be\n able to check the state of the printer and job (advanced printing) while printing is in progress.\n In order to do that, the printer MUST allow the client to call the /privet/info and\n /privet/printer/jobstate APIs while processing /privet/printer/submitdoc API calls. Il est\n recommended for all clients to start a new thread to execute the /privet/printer/submitdoc API\n call, so that the main thread can use the /privet/info and /privet/printer/jobstate APIs to check\n printer and job states.\nRemarque: Upon completion or abortion of the local print job, it is strongly\n recommended (and will be required in a future version of this spec) to report the final state of\n the job to the /cloudprint/submit interface for accounting and user experience purposes. le\n parameters "printerid", "title", "contentType" and "final_semantic_state" (in\n PrintJobState format) are required, and the parameters "tag" (repeated\n parameter) and "ticket" (the ticket of the job in CloudJobTicket format).\n Note that the provided PrintJobState must actually be final, i.e. its type must be DONE or\n ABORTED, and a cause must be provided in the case that it is ABORTED (see\n JobState for details). Also note that this use of the\n /cloudprint/submit interface to report local print jobs is not mentioned in\n its specification because that section is intended to describe\n the interface's primary use: submitting a print job with the document to print provided in the\n "content" parameter.\n5.2.1. Input\n/privet/printer/submitdoc API has the following input parameters:"},{"id":"text-158","heading":"Text","content":"Name\nValeur"},{"id":"text-159","heading":"Text","content":"job_id\n(optional) Print job id. May be omitted for simple printing case\n (voir au dessus). Must match the one returned by the printer."},{"id":"text-160","heading":"Text","content":"user_name\n(optional) Human readable user name. This is not definitive, and should\n only be used for print job annotations. If job is re-posted to the Cloud Print service this\n string should be attached to the Cloud Print job."},{"id":"text-161","heading":"Text","content":"client_name\n(optional) Name of the client application making this request. Pour\n display purposes only. If job is re-posted to the Cloud Print service this string should be\n attached to the Cloud Print job."},{"id":"text-162","heading":"Text","content":"job_name\n(optional) Name of the print job to be recorded. If job is re-posted to\n the Cloud Print service this string should be attached to the Cloud Print job."},{"id":"text-163","heading":"Text","content":"offline\n(optional) Could only be "offline=1". In this case printer should\n only try printing offline (no re-post to Cloud Print server)."},{"id":"text-164","heading":"Text","content":"Request body should contain a valid document for printing. "Content-Length" should\n include the correct length of the request. "Content-Type" header should be set to\n document MIME type and match one of the types in the CDD (unless CDD specifies "*/*"). \nClients are HIGHLY recommended to provide a valid user name (or email), a client name and a job\n name with this request. Those fields are only used in UIs to improve user experience.\n5.2.2. Return\n/privet/printer/submitdoc API returns following data:"},{"id":"text-165","heading":"Text","content":"Value name\nValue type\nLa description"},{"id":"text-166","heading":"Text","content":"job_id\nchaîne\nID of the newly created print job (simple printing) or\n job_id specified in the request (advanced printing)."},{"id":"text-167","heading":"Text","content":"expires_in\nint\nNumber of seconds this print job is valid."},{"id":"text-168","heading":"Text","content":"job_type\nchaîne\nContent-type of the submitted document."},{"id":"text-169","heading":"Text","content":"job_size\nint 64 bit\nSize of the print data in bytes."},{"id":"text-170","heading":"Text","content":"job_name\nchaîne\n(optional) Same job name as in input (if any)."},{"id":"text-171","heading":"Text","content":"Exemple:"},{"id":"text-172","heading":"Text","content":" "job_id": "123",\n "expires_in": 500,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document""},{"id":"text-173","heading":"Text","content":"5.2.3. les erreurs\n/privet/printer/submitdoc API may return the following errors (see Errors section for details):"},{"id":"text-174","heading":"Text","content":"Erreur\nLa description"},{"id":"text-175","heading":"Text","content":"invalid_print_job\nInvalid/expired job id is specified in the request. Retry after\n timeout."},{"id":"text-176","heading":"Text","content":"invalid_document_type\nDocument MIME-type is not supported by the printer."},{"id":"text-177","heading":"Text","content":"invalid_document\nSubmitted document is invalid."},{"id":"text-178","heading":"Text","content":"document_too_large\nDocument exceeds maximum size allowed."},{"id":"text-179","heading":"Text","content":"printer_busy\nPrinter is busy and can’t currently process document. Recommencez\n after timeout."},{"id":"text-180","heading":"Text","content":"printer_error\nPrinter is in error state and requires user interaction to fix it.\n Description should contain more detailed explanation (e.g. "Paper jam in Tray 1")."},{"id":"text-181","heading":"Text","content":"invalid_params\nInvalid parameters specified in the request. (Unknown parameters\n should be safely ignored for future compatibility)"},{"id":"text-182","heading":"Text","content":"user_cancel\nUser explicitly cancelled printing process from the device."},{"id":"text-183","heading":"Text","content":"server_error\nPosting document to Cloud Print has failed."},{"id":"text-184","heading":"Text","content":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request."},{"id":"text-185","heading":"Text","content":"If the device is not exposing /privet/printer/submitdoc, it MUST return HTTP 404 error. Si la\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\nRemarque: /privet/printer/submitdoc API may require special handling on printer\n side (because of the large payload attached). In some cases (depends on the printer HTTP server\n implementation and platform), printer may close socket BEFORE returning HTTP error. In other,\n printer may return 503 error (instead of Privet error). Printers SHOULD try as much as possible to\n return Privet. However, every client implementing Privet specification SHOULD be able to handle\n socket close (no HTTP error) and 503 HTTP error cases for /privet/printer/submitdoc API. Dans ce\n case, client SHOULD handle it as a Privet "printer_busy" error with\n "timeout" set to 15 seconds. To avoid infinite retries, client may stop retrying after\n a reasonable number of attempts (for example, 3).\n5.3. /privet/printer/jobstate API\n/privet/printer/jobstate API is OPTIONAL (see Simple Printing above). It is an HTTP GET request.\n/privet/printer/jobstate API MUST check for a valid "X-Privet-Token" header. The device\nMUST implement this API on "/privet/printer/jobstate" url:\nGET /privet/printer/jobstate HTTP/1.1\nWhen receiving a /privet/printer/jobstate API call, a printer should return the status of the\nrequested print job or invalid_print_job error.\n5.3.1. Input\n/privet/printer/jobstate API has following input parameters:"},{"id":"text-186","heading":"Text","content":"Name\nValeur"},{"id":"text-187","heading":"Text","content":"job_id\nPrint job ID to return status for."},{"id":"text-188","heading":"Text","content":"5.3.2. Return\n/privet/printer/jobstate API returns the following data:"},{"id":"text-189","heading":"Text","content":"Value name\nValue type\nLa description"},{"id":"text-190","heading":"Text","content":"job_id\nchaîne\nPrint job id there status information is for."},{"id":"text-191","heading":"Text","content":"state\nchaîne\ndraft – print job has been created on the device (no\n /privet/printer/submitdoc calls have been received yet).\n queued – print job has been received and queued, but printing has not started yet.\n in_progress – print job is in the progress of printing.\n stopped – print job has been paused, but can be restarted manually or automatically.\n terminé – print job is done.\n aborted – print job failed."},{"id":"text-192","heading":"Text","content":"la description\nchaîne\n(optional) Human readable description of the print job\n status. Should include additional information if statestopped or\n aborted. le semantic_state field usually provides better and more meaningful\n description to the client."},{"id":"text-193","heading":"Text","content":"expires_in\nint\nNumber of seconds this print job is valid."},{"id":"text-194","heading":"Text","content":"job_type\nchaîne\n(optional) Content-type of the submitted document."},{"id":"text-195","heading":"Text","content":"job_size\nint 64 bit\n(optional) Size of the print data in bytes."},{"id":"text-196","heading":"Text","content":"job_name\nchaîne\n(optional) Same job name as in input (if any)."},{"id":"text-197","heading":"Text","content":"server_job_id\nchaîne\n(optional) ID of the job returned from the server (if\n job has been posted to Cloud Print service). Omitted for offline printing."},{"id":"text-198","heading":"Text","content":"semantic_state\nJSON\n(optional) Semantic state of the job in\n PrintJobState format."},{"id":"text-199","heading":"Text","content":"Example (printing by reporting through Cloud Print):"},{"id":"text-200","heading":"Text","content":" "job_id": "123",\n "state": "in_progress",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document",\n "server_job_id": "1111-2222-3333-4444""},{"id":"text-201","heading":"Text","content":"Example (offline printing error):"},{"id":"text-202","heading":"Text","content":" "job_id": "123",\n "state": "stopped",\n "description": "Out of paper",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document""},{"id":"text-203","heading":"Text","content":"Example (print job aborted by the user):"},{"id":"text-204","heading":"Text","content":" "job_id": "123",\n "state": "aborted",\n "description": "User action",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": 123456,\n "job_name": "My PDF document",\n "semantic_state": \n "version": "1.0",\n "state": \n "type": "ABORTED",\n "user_action_cause": "action_code": "CANCELLED"\n ,\n "pages_printed": 7\n "},{"id":"text-205","heading":"Text","content":"Example (print job stopped due to out of paper). Notice the reference to the device state. le\nclient will need to call the /privet/info API to get more details about the device state:"},{"id":"text-206","heading":"Text","content":" "job_id": "123",\n "state": "stopped",\n "description": "Out of paper",\n "expires_in": 100,\n "job_type": "application/pdf",\n "job_size": "123456",\n "job_name": "My PDF document",\n "semantic_state": \n "version": "1.0",\n "state": \n "type": "STOPPED",\n "device_state_cause": "error_code": "INPUT_TRAY"\n ,\n "pages_printed": 7\n "},{"id":"text-207","heading":"Text","content":"5.3.3. les erreurs\n/privet/printer/jobstate API may return the following errors (see Errors section for details):"},{"id":"text-208","heading":"Text","content":"Erreur\nLa description"},{"id":"text-209","heading":"Text","content":"invalid_print_job\nInvalid/expired job ID is specified in the request."},{"id":"text-210","heading":"Text","content":"server_error\nGetting print job status (for print jobs posted to Cloud Print) has\n failed."},{"id":"text-211","heading":"Text","content":"invalid_x_privet_token\nX-Privet-Token is invalid or empty in the request."},{"id":"text-212","heading":"Text","content":"If device is not exposing /privet/printer/jobstate, it MUST return HTTP 404 error. Si la\n X-Privet-Token header is missing, the device MUST return HTTP 400 error.\n6. Appendix\n6.1. Default behavior and settings\nThis section will explain the default behavior we expect from ALL Privet-compatible devices."},{"id":"text-213","heading":"Text","content":"Out-of-the-box devices should support only /privet/info et\n /privet/register APIs. All other APIs (e.g. /privet/accesstoken, local printing) should\n be disabled.\nRegistration requires physical interaction with a device."},{"id":"text-214","heading":"Text","content":"User MUST take a physical action on the device (e.g., pressing a button) to confirm their\n access to the device. \nAfter the user takes the action noted above, the printer should send the\n /cloudprint/register request. It should not send this request until after the action is taken\n (see Sequence Diagram 1).\nIf the device is processing a /privet/register request (for instance, waiting on the action\n above), it must reject all other /privet/register requests. The device MUST return the\n device_busy error in this case.\nThe device should timeout any /register request that does not receive the physical action\n mentioned above within 60 seconds. The device MUST return the confirmation_timeout error in\n this case.\nOptional: Recommended but not required, the following may improve user experience:"},{"id":"text-215","heading":"Text","content":"The printer might flash a light or its screen to indicate that the user needs to take an\n action to confirm registration.\nThe printer might state on its screen that ‘it is being registered to Google Cloud\n Print for user ‘abc@def.com’ – press OK to\n continue’, where abc@def.com is the user\n parameter from the /register API call. This would make it clearer to a user that:"},{"id":"text-216","heading":"Text","content":"it is their registration request that s/he is confirming\nwhat is happening if s/he didn’t trigger the request."},{"id":"text-217","heading":"Text","content":"In addition to a physical action to confirm from the printer (e.g., ‘Press the OK\n button’), a printer may also offer the user a button to cancel the request (e.g.,\n ‘Press Cancel to reject’). This would allow users who did not trigger the\n registration request to cancel it before the 60 second timeout. The device MUST return the\n user_cancel error in this case."},{"id":"text-218","heading":"Text","content":"Ownership transfers:"},{"id":"text-219","heading":"Text","content":"The device may be deleted explicitly from the Cloud service."},{"id":"text-220","heading":"Text","content":"If the device receives success, but no device description as a result of\n /cloudprint/printer (for GCP) call, it MUST revert to default (out-of-the-box) mode. \nIf the device’s credentials no longer work (explicitly because of "invalid\n credentials" response from the server), it MUST revert to default (out-of-the-box)\n mode."},{"id":"text-221","heading":"Text","content":"Local factory reset MUST clear device’s credentials and set it to default state.\nOptional: The device may provide a menu item to clear credentials and put it into default\n mode."},{"id":"text-222","heading":"Text","content":"Devices supporting XMPP notifications MUST include the ability to ping the server. The ping\n timeout MUST be controllable from the server through "local_settings".\nThe device may explicitly ping the server (/cloudprint/printer API for GCP, in addition to\n XMPP pings) no more often than once a day (24 hours) to make sure they are in sync. Il est\n recommended to randomize the check window within 24-32 hour window.\nOptional: For Cloud Print devices, it is recommended but not required to have a manual way\n (button) to allow the user to initiate a check for new print jobs from the device. Some printers\n already have this.\nOptional. Enterprise printers may have an option to disable local discovery completely. Dans\n such case, the device MUST update these local settings on the server. New local settings MUST be\n empty (setting "local_discovery" to "false", means that it can be\n re-enabled from the GCP Service)."},{"id":"text-223","heading":"Text","content":"6.1.2 Default Registration Diagram"},{"id":"text-224","heading":"Text","content":"6.2. XSSI and XSRF attacks and prevention\nThis section will explain the possibility of XSSI and XSRF attacks on the device and how to protect\nfrom them (including token generation techniques).\nMore details are here:"},{"id":"text-225","heading":"Text","content":"http://googleonlinesecurity.blogspot.com/2011/05/website-security-for-webmasters.html\nNormally, XSSI and XSRF attacks are possible when a site is using cookie authentication\nmechanisms. While Google doesn’t use cookies with their Cloud Print Service, such attacks are\nstill possible. Local network access, by design, implicitly trusts requests.\n6.2.1. XSSI\nIt is possible for a malicious website to guess the IP address and port number of a\nPrivet-compatible device and to try to call the Privet API using "src="http://developers.google.com/inside of a tag:"},{"id":"text-226","heading":"Text","content":"Without protection, malicious websites would be able to execute API calls and access results.\nTo prevent this type of attack, ALL Privet API calls MUST require the\n"X-Privet-Token" header in the request. "src="http://developers.google.com/script tags are\nnot able to add headers, effectively guarding against this type of attack.\n6.2.2. XSRF"},{"id":"text-227","heading":"Text","content":"http://en.wikipedia.org/wiki/Cross-site_request_forgery\nIt is possible for a malicious website to guess the IP address and port number of a\nPrivet-compatible device and try to call Privet API using an , forms, or some other\ncross-website loading mechanism. Attackers would not be able to access the results of the request,\nbut if the request would perform an action (e.g. printing), they could trigger it.\nTo prevent this attack, we require the following protection:"},{"id":"text-228","heading":"Text","content":"Leave /privet/info API open to XSRF\n/privet/info API MUST NOT perform any actions on the device\nUse /privet/info API to receive x-privet-token\nAll other APIs MUST check for a valid x-privet-token in "X-Privet-Token" header.\nx-privet-token SHOULD be valid for only 24 hours."},{"id":"text-229","heading":"Text","content":"Even if an attacker is able to execute the /privet/info API, they would not be able to\nread x-privet-token from the response and therefore would not be able to call any other API.\nIt is strongly recommended to generate the XSRF token using the following algorithm:\nXSRF_token = base64( SHA1(device_secret + DELIMITER + issue_timecounter) + DELIMITER + issue_timecounter )\nXSRF Token Generation Elements:"},{"id":"text-230","heading":"Text","content":"DELIMITER is a special character, usually ‘:’\nissue_timecounter is a number of seconds since some event (epoch for timestamp) or\n device boot time (for CPU counters). issue_timecounter is constantly increasing when\n the device is up and running (see token verification below).\nSHA1 – hash function using SHA1 algorithm\nbase64 – base64 encoding\ndevice_secret – secret specific to the device. Device secret MUST be updated on every\n restart."},{"id":"text-231","heading":"Text","content":"Recommended ways to generate device secret:"},{"id":"text-232","heading":"Text","content":"Generate a new UUID on every restart\nGenerate a 64 bit random number on every restart"},{"id":"text-233","heading":"Text","content":"The device is not required to store all of the XSRF tokens it has issued. When the device needs\n to verify a XSRF token for validity, it should base64-decode the token. Get the\n issue_timecounter from the second half (cleartext), and try to produce SHA1 hash of\n device_secret + DELIMITER + issue_timecounter où issue_timecounter is from\n the token. If the newly generated SHA1 matches the one in the token, device must now check if the\n issue_timecounter is within the validity period from (24 hours) of the current time\n counter. To do so, device takes the current time counter (CPU counter for example) and subtracts\n issue_timecounter à partir de cela. The result MUST be the number of seconds since token\n issue.\nImportant: This is the recommended way to implement XSRF\n protection. Clients of the Privet specification shall not try to understand XSRF token, instead\n they shall treat is as a blackbox. Figure 6.2.3 illustrates a recommended way to implement the\n X-Privet-Token and verification of a typical request.\n6.2.3 X-Privet Token Generation and Verification Sequence Diagram"},{"id":"text-234","heading":"Text","content":"6.3. Workflow diagrams\nThis section will illustrate a workflow in different cases.\n6.3.1. Printer out of the box workflow"},{"id":"text-235","heading":"Text","content":"6.3.2. Registered printer startup"},{"id":"text-236","heading":"Text","content":"6.3.3 XMPP notifications handling workflow"},{"id":"text-237","heading":"Text","content":"6.3.4. Check printer settings workflow"},{"id":"text-238","heading":"Text","content":"Click to rate this post!\n \n [Total: 0 Average: 0]"}],"media":{"primary_image":"https://tutos-gameserver.fr/wp-content/uploads/2019/10/google-blue.png"},"relations":[{"rel":"canonical","href":"https://tutos-gameserver.fr/2019/10/13/privet-cloud-print-developpeurs-google-bien-choisir-son-serveur-d-impression/"},{"rel":"alternate","href":"https://tutos-gameserver.fr/2019/10/13/privet-cloud-print-developpeurs-google-bien-choisir-son-serveur-d-impression/llm","type":"text/html"},{"rel":"alternate","href":"https://tutos-gameserver.fr/2019/10/13/privet-cloud-print-developpeurs-google-bien-choisir-son-serveur-d-impression/llm.json","type":"application/json"},{"rel":"llm-manifest","href":"https://tutos-gameserver.fr/llm-endpoints-manifest.json","type":"application/json"}],"http_headers":{"X-LLM-Friendly":"1","X-LLM-Schema":"1.1.0","Content-Security-Policy":"default-src 'none'; img-src * data:; style-src 'unsafe-inline'"},"license":"CC BY-ND 4.0","attribution_required":true,"allow_cors":false}