QtCoap Namespace

Contient divers identifiants utilisés dans le module Qt CoAP. 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 des types

enum class QtCoap::Error

Indique la condition d'erreur constatée lors du traitement de la demande.

Constante	Valeur	Description de l'erreur
`QtCoap::Error::Ok`	`0`	Pas de condition d'erreur.
`QtCoap::Error::HostNotFound`	`1`	Le nom de l'hôte distant n'a pas été trouvé.
`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 demande n'a pas été reconnue.
`QtCoap::Error::Unauthorized`	`5`	Le client n'est pas autorisé à effectuer l'action demandée.
`QtCoap::Error::BadOption`	`6`	La demande n'a pas pu être comprise par le serveur 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 n'a pas été trouvée.
`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 demande 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 continuer. 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à rejetés.
`QtCoap::Error::PreconditionFailed`	`12`	Une ou plusieurs conditions indiquées dans les champs de l'en-tête de la demande ont été évaluées comme fausses lorsqu'elles ont été testées sur le serveur.
`QtCoap::Error::RequestEntityTooLarge`	`13`	La charge utile de la demande est plus importante que ce que le serveur veut ou peut traiter.
`QtCoap::Error::UnsupportedContentFormat`	`14`	La charge utile est dans un format qui n'est pas 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 demande.
`QtCoap::Error::NotImplemented`	`16`	Le serveur ne prend pas en charge la fonctionnalité requise pour répondre à la demande.
`QtCoap::Error::BadGateway`	`17`	Une erreur s'est produite avec un serveur en amont.
`QtCoap::Error::ServiceUnavailable`	`18`	Le service est actuellement indisponible.
`QtCoap::Error::GatewayTimeout`	`19`	Le serveur, en tant que passerelle ou proxy, n'a pas reçu de réponse en temps voulu d'un serveur en amont auquel il devait accéder pour répondre à la demande.
`QtCoap::Error::ProxyingNotSupported`	`20`	Le serveur ne peut pas ou ne veut pas agir en tant que forward-proxy pour l'URI spécifié 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 spécifie les méthodes de requête CoAP.

Constante	Valeur	Description de la méthode
`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 de l'enum
`QtCoap::MulticastGroup::AllCoapNodesIPv4`	`0`	IPv4 "All CoAP Nodes" address 224.0.1.187, from the "IPv4 Multicast Address Space Registry".
`QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal`	`1`	IPv6 "All CoAP Nodes" link-local scoped address FF02::FD, from the "IPv6 Multicast Address Space Registry".
`QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal`	`2`	IPv6 "All CoAP Nodes" site-local scoped address FF05::FD, from the "IPv6 Multicast Address Space Registry".

enum QtCoap::Port

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

Constante	Valeur	Description du port
`QtCoap::DefaultPort`	`5683`	Le port par défaut utilisé pour la transmission non sécurisée.
`QtCoap::DefaultSecurePort`	`5684`	Le 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 demande a abouti et a entraîné la création de nouvelles ressources. Ce code de réponse correspond à HTTP 201 "Created".
`QtCoap::ResponseCode::Deleted`	`0x42`	La ressource a été supprimée avec succès. Ce code de réponse correspond à HTTP 204 "No Content" mais n'est utilisé qu'en réponse à des demandes qui font que la ressource n'est plus disponible, telles que DELETE et, dans certaines circonstances, POST.
`QtCoap::ResponseCode::Valid`	`0x43`	Ce code de réponse correspond à HTTP 304 "Not Modified" mais n'est utilisé que pour indiquer que la réponse identifiée par l'étiquette d'entité donnée 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 à HTTP 204 "No Content" mais n'est utilisé qu'en réponse aux requêtes POST et PUT.
`QtCoap::ResponseCode::Content`	`0x45`	La demande a abouti. Ce code de réponse correspond à 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 réussi et que le serveur enverra d'autres blocs.
`QtCoap::ResponseCode::BadRequest`	`0x-80`	La demande n'a pas été reconnue. Ce code de réponse correspond à 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 à HTTP 401 "Unauthorized".
`QtCoap::ResponseCode::BadOption`	`0x-7e`	La demande n'a pas pu être comprise 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 à HTTP 403 "Forbidden".
`QtCoap::ResponseCode::NotFound`	`0x-7c`	La ressource demandée n'a pas été trouvée. 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 "Method Not Allowed" mais sans parallèle avec le champ d'en-tête "Allow".
`QtCoap::ResponseCode::NotAcceptable`	`0x-7a`	Aucune ressource satisfaisant aux critères d'acceptation de la demande n'a été trouvée. Ce code de réponse correspond à 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 continuer.
`QtCoap::ResponseCode::PreconditionFailed`	`0x-74`	Les conditions préalables données dans les champs de l'en-tête de la requête ont été évaluées à `false` lorsqu'elles ont été testées sur le serveur. Ce code de réponse correspond à HTTP 412 "Precondition Failed".
`QtCoap::ResponseCode::RequestEntityTooLarge`	`0x-73`	La charge utile de la demande est plus importante que ce que le serveur veut ou peut traiter. Ce code de réponse correspond à HTTP 413 "Request Entity Too Large".
`QtCoap::ResponseCode::UnsupportedContentFormat`	`0x-72`	La charge utile est dans un format qui n'est pas pris en charge par cette méthode sur la ressource cible. Ce code de réponse correspond à HTTP 415 "Unsupported Media Type".
`QtCoap::ResponseCode::InternalServerFault`	`0x-60`	Le serveur a rencontré une condition inattendue qui l'a empêché de répondre à la demande. Ce code de réponse correspond à HTTP 500 "Internal Server Error".
`QtCoap::ResponseCode::NotImplemented`	`0x-5f`	Le serveur ne prend pas en charge la fonctionnalité requise pour répondre à la demande. Ce code de réponse correspond à HTTP 501 "Not Implemented".
`QtCoap::ResponseCode::BadGateway`	`0x-5e`	Une erreur s'est produite avec un serveur en amont. Ce code de réponse correspond à HTTP 502 "Bad Gateway".
`QtCoap::ResponseCode::ServiceUnavailable`	`0x-5d`	Le service est actuellement indisponible. Ce code de réponse correspond à HTTP 503 "Service Unavailable".
`QtCoap::ResponseCode::GatewayTimeout`	`0x-5c`	Le serveur, qui agit 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 à HTTP 504 "Gateway Timeout".
`QtCoap::ResponseCode::ProxyingNotSupported`	`0x-5b`	Le serveur ne peut pas ou ne veut pas agir en tant que proxy pour l'URI spécifié dans l'option Proxy-Uri ou en utilisant le schéma spécifié dans Proxy-Scheme.
`QtCoap::ResponseCode::InvalidCode`	`0xFF`	Un 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 RFC 7252.

Constante	Valeur	Description du mode de sécurité
`QtCoap::SecurityMode::NoSecurity`	`0`	Il n'y a pas de sécurité au niveau du protocole (DTLS est désactivé).
`QtCoap::SecurityMode::PreSharedKey`	`1`	DTLS est activé. L'authentification PSK sera utilisée pour la sécurité.
`QtCoap::SecurityMode::RawPublicKey`	`2`	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`	DTLS est activé. Une paire de clés asymétriques avec 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.