QtCoap Namespace

Contient divers identifiants utilisés dans l'ensemble du module « Qt CoAP ». En savoir plus...

En-tête :	`#include <QtCoap>`

CMake :	`find_package(Qt6 REQUIRED COMPONENTS Coap)` `target_link_libraries(mytarget PRIVATE Qt6::Coap)`
qmake :	`QT += coap`

Types

enum class	Error { Ok, HostNotFound, AddressInUse, TimeOut, BadRequest, …, Unknown }
enum class	Method { Invalid, Get, Post, Put, Delete, Other }
enum class	MulticastGroup { AllCoapNodesIPv4, AllCoapNodesIPv6LinkLocal, AllCoapNodesIPv6SiteLocal }
enum	Port { DefaultPort, DefaultSecurePort }
enum class	ResponseCode { EmptyMessage, Created, Deleted, Valid, Changed, …, InvalidCode }
enum class	SecurityMode { NoSecurity, PreSharedKey, RawPublicKey, Certificate }

Description détaillée

Documentation sur les types

enum class QtCoap::Error

Indique la condition d'erreur détectée lors du traitement de la requête.

Constante	Valeur	Description
`QtCoap::Error::Ok`	`0`	Aucune erreur.
`QtCoap::Error::HostNotFound`	`1`	Le nom de l'hôte distant est introuvable.
`QtCoap::Error::AddressInUse`	`2`	L'adresse est déjà utilisée.
`QtCoap::Error::TimeOut`	`3`	La réponse n'est pas arrivée à temps.
`QtCoap::Error::BadRequest`	`4`	La requête n'a pas été reconnue.
`QtCoap::Error::Unauthorized`	`5`	Le client n'est pas autorisé à effectuer l'action demandée.
`QtCoap::Error::BadOption`	`6`	Le serveur n'a pas pu comprendre la requête en raison d'une ou plusieurs options non reconnues ou mal formées.
`QtCoap::Error::Forbidden`	`7`	L'accès à cette ressource est interdit.
`QtCoap::Error::NotFound`	`8`	La ressource demandée est introuvable.
`QtCoap::Error::MethodNotAllowed`	`9`	Le serveur n'autorise pas la méthode utilisée pour l'URL demandée.
`QtCoap::Error::NotAcceptable`	`10`	Aucune ressource répondant aux critères d'acceptation de la requête n'a été trouvée.
`QtCoap::Error::RequestEntityIncomplete`	`11`	Le serveur n’a pas reçu les blocs du corps de la requête dont il a besoin pour poursuivre le traitement. Le client n’a pas envoyé tous les blocs, ne les a pas envoyés dans l’ordre requis par le serveur, ou les a envoyés il y a suffisamment longtemps pour que le serveur les ait déjà supprimés.
`QtCoap::Error::PreconditionFailed`	`12`	Une ou plusieurs conditions indiquées dans les champs d’en-tête de la requête ont été évaluées comme fausses lors de leur vérification sur le serveur.
`QtCoap::Error::RequestEntityTooLarge`	`13`	La charge utile de la requête est trop volumineuse pour que le serveur puisse ou veuille la traiter.
`QtCoap::Error::UnsupportedContentFormat`	`14`	La charge utile est dans un format non pris en charge par cette méthode sur la ressource cible.
`QtCoap::Error::InternalServerFault`	`15`	Le serveur a rencontré une condition inattendue qui l’a empêché de répondre à la requête.
`QtCoap::Error::NotImplemented`	`16`	Le serveur ne prend pas en charge les fonctionnalités requises pour répondre à la requête.
`QtCoap::Error::BadGateway`	`17`	Une erreur s'est produite au niveau d'un serveur en amont.
`QtCoap::Error::ServiceUnavailable`	`18`	Le service est actuellement indisponible.
`QtCoap::Error::GatewayTimeout`	`19`	Le serveur, alors qu'il agissait en tant que passerelle ou proxy, n'a pas reçu de réponse en temps voulu de la part d'un serveur en amont auquel il devait accéder pour traiter la requête.
`QtCoap::Error::ProxyingNotSupported`	`20`	Le serveur ne peut pas ou ne souhaite pas agir en tant que proxy de transfert pour l’URI spécifiée dans l’option Proxy-Uri ou en utilisant le schéma spécifié dans Proxy-Scheme.
`QtCoap::Error::Unknown`	`21`	Une erreur inconnue s'est produite.

enum class QtCoap::Method

Cette énumération définit les méthodes de requête CoAP.

Constante	Valeur	Description
`QtCoap::Method::Invalid`	`0`	Méthode de requête par défaut pour une requête vide.
`QtCoap::Method::Get`	`1`	Méthode GET.
`QtCoap::Method::Post`	`2`	Méthode POST.
`QtCoap::Method::Put`	`3`	Méthode PUT.
`QtCoap::Method::Delete`	`4`	Méthode DELETE.
`QtCoap::Method::Other`	`5`	Autre méthode de requête.

enum class QtCoap::MulticastGroup

Cette énumération représente les adresses de groupes de multidiffusion CoAP définies dans la RFC 7252.

Constante	Valeur	Description
`QtCoap::MulticastGroup::AllCoapNodesIPv4`	`0`	Adresse IPv4 « Tous les nœuds CoAP » 224.0.1.187, issue du « Registre de l'espace d'adressage multicast IPv4 ».
`QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal`	`1`	Adresse IPv6 « Tous les nœuds CoAP » de portée locale FF02::FD, issue du « Registre des espaces d’adressage multicast IPv6 ».
`QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal`	`2`	Adresse IPv6 « Tous les nœuds CoAP » de portée locale au site FF05::FD, issue du « Registre de l'espace d'adressage multicast IPv6 ».

enum QtCoap::Port

Cette énumération définit les valeurs par défaut des ports CoAP.

Constante	Valeur	Description
`QtCoap::DefaultPort`	`5683`	Port par défaut utilisé pour la transmission non sécurisée.
`QtCoap::DefaultSecurePort`	`5684`	Port par défaut utilisé pour la transmission sécurisée.

enum class QtCoap::ResponseCode

Cette énumération représente le code de réponse du protocole CoAP, tel que défini dans les RFC 7252 et RFC 7959.

Constante	Valeur	Description
`QtCoap::ResponseCode::EmptyMessage`	`0x00`	Code de réponse pour un message vide.
`QtCoap::ResponseCode::Created`	`0x41`	La requête a abouti et a entraîné la création de nouvelles ressources. Ce code de réponse correspond au code HTTP 201 « Created ».
`QtCoap::ResponseCode::Deleted`	`0x42`	La ressource a été supprimée avec succès. Ce code de réponse correspond au code HTTP 204 « No Content », mais n’est utilisé qu’en réponse à des requêtes entraînant la suppression de la ressource, telles que DELETE et, dans certaines circonstances, POST.
`QtCoap::ResponseCode::Valid`	`0x43`	Ce code de réponse est lié au code HTTP 304 « Not Modified », mais n’est utilisé que pour indiquer que la réponse identifiée par l’entité-balise fournie dans l’option ETag est valide.
`QtCoap::ResponseCode::Changed`	`0x44`	La ressource a été modifiée avec succès. Ce code de réponse correspond au code HTTP 204 « No Content », mais n’est utilisé qu’en réponse aux requêtes POST et PUT.
`QtCoap::ResponseCode::Content`	`0x45`	La requête a abouti. Ce code de réponse correspond au code HTTP 200 « OK », mais n’est utilisé qu’en réponse aux requêtes GET.
`QtCoap::ResponseCode::Continue`	`0x5F`	Indique que le transfert du bloc actuel a abouti et que le serveur enverra d’autres blocs.
`QtCoap::ResponseCode::BadRequest`	`0x-80`	La requête n’a pas été reconnue. Ce code de réponse correspond au code HTTP 400 « Bad Request ».
`QtCoap::ResponseCode::Unauthorized`	`0x-7f`	Le client n’est pas autorisé à effectuer l’action demandée. Ce code de réponse correspond au code HTTP 401 « Unauthorized ».
`QtCoap::ResponseCode::BadOption`	`0x-7e`	La requête n’a pas pu être interprétée par le serveur en raison d’options non reconnues.
`QtCoap::ResponseCode::Forbidden`	`0x-7d`	L'accès à cette ressource est interdit. Ce code de réponse correspond au code HTTP 403 « Forbidden ».
`QtCoap::ResponseCode::NotFound`	`0x-7c`	La ressource demandée est introuvable. Ce code de réponse correspond à HTTP 404 « Not Found ».
`QtCoap::ResponseCode::MethodNotAllowed`	`0x-7b`	Le serveur n'autorise pas la méthode utilisée pour l'URL demandée. Ce code de réponse correspond à HTTP 405 « Méthode non autorisée », mais sans équivalent du champ d'en-tête « Allow ».
`QtCoap::ResponseCode::NotAcceptable`	`0x-7a`	Aucune ressource répondant aux critères d'acceptation de la requête n'a été trouvée. Ce code de réponse correspond au code HTTP 406 « Not Acceptable », mais sans entité de réponse.
`QtCoap::ResponseCode::RequestEntityIncomplete`	`0x-78`	Le serveur n’a pas reçu tous les blocs du corps de la requête dont il a besoin pour poursuivre le traitement.
`QtCoap::ResponseCode::PreconditionFailed`	`0x-74`	Les conditions préalables indiquées dans les champs d’en-tête de la requête ont été évaluées comme « `false` » lors de leur vérification sur le serveur. Ce code de réponse correspond à HTTP 412 « Condition préalable non satisfaite ».
`QtCoap::ResponseCode::RequestEntityTooLarge`	`0x-73`	La charge utile de la requête est trop volumineuse pour que le serveur puisse ou veuille la traiter. Ce code de réponse correspond au code HTTP 413 « Entité de requête trop volumineuse ».
`QtCoap::ResponseCode::UnsupportedContentFormat`	`0x-72`	La charge utile est dans un format non pris en charge par cette méthode sur la ressource cible. Ce code de réponse correspond à HTTP 415 « Type de média non pris en charge ».
`QtCoap::ResponseCode::InternalServerFault`	`0x-60`	Le serveur a rencontré une condition inattendue qui l'a empêché de répondre à la requête. Ce code de réponse correspond à HTTP 500 « Erreur interne du serveur ».
`QtCoap::ResponseCode::NotImplemented`	`0x-5f`	Le serveur ne prend pas en charge la fonctionnalité requise pour répondre à la requête. Ce code de réponse correspond au code HTTP 501 « Non implémenté ».
`QtCoap::ResponseCode::BadGateway`	`0x-5e`	Une erreur s'est produite au niveau d'un serveur en amont. Ce code de réponse correspond au code HTTP 502 « Bad Gateway ».
`QtCoap::ResponseCode::ServiceUnavailable`	`0x-5d`	Le service est actuellement indisponible. Ce code de réponse correspond à HTTP 503 « Service indisponible ».
`QtCoap::ResponseCode::GatewayTimeout`	`0x-5c`	Le serveur, agissant en tant que passerelle ou proxy, n’a pas reçu de réponse en temps voulu de la part d’un serveur en amont. Ce code de réponse correspond au code HTTP 504 « Délai d’attente de la passerelle ».
`QtCoap::ResponseCode::ProxyingNotSupported`	`0x-5b`	Le serveur ne peut pas ou ne souhaite pas agir en tant que proxy de transfert pour l’URI spécifiée dans l’option Proxy-Uri ou en utilisant le schéma spécifié dans Proxy-Scheme.
`QtCoap::ResponseCode::InvalidCode`	`0xFF`	Code de réponse non valide.

enum class QtCoap::SecurityMode

Spécifie le mode de sécurité utilisé pour sécuriser une connexion CoAP, tel que défini dans la norme RFC 7252.

Constante	Valeur	Description
`QtCoap::SecurityMode::NoSecurity`	`0`	Il n'y a pas de sécurité au niveau du protocole (DTLS est désactivé).
`QtCoap::SecurityMode::PreSharedKey`	`1`	Le DTLS est activé. L'authentification PSK sera utilisée pour la sécurité.
`QtCoap::SecurityMode::RawPublicKey`	`2`	Le protocole DTLS est activé. Une paire de clés asymétriques sans certificat (une clé publique brute) sera utilisée pour la sécurité. Ce mode n'est pas encore pris en charge.
`QtCoap::SecurityMode::Certificate`	`3`	Le protocole DTLS est activé. Une paire de clés asymétriques associée à un certificat X.509 sera utilisée pour la sécurité.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.