QtCoap Namespace
Contiene varios identificadores utilizados en el módulo Qt CoAP. Más...
| Cabecera: | #include <QtCoap> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Coap)target_link_libraries(mytarget PRIVATE Qt6::Coap) |
| qmake: | QT += coap |
Tipos
| 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 } |
Documentación de tipos
enum class QtCoap::Error
Indica la condición de error encontrada durante el procesamiento de la solicitud.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::Error::Ok | 0 | No hay condición de error. |
QtCoap::Error::HostNotFound | 1 | No se ha encontrado el nombre del host remoto. |
QtCoap::Error::AddressInUse | 2 | La dirección ya está en uso. |
QtCoap::Error::TimeOut | 3 | La respuesta no ha llegado a tiempo. |
QtCoap::Error::BadRequest | 4 | No se ha reconocido la solicitud. |
QtCoap::Error::Unauthorized | 5 | El cliente no está autorizado a realizar la acción solicitada. |
QtCoap::Error::BadOption | 6 | La solicitud no ha podido ser entendida por el servidor debido a una o más opciones no reconocidas o malformadas. |
QtCoap::Error::Forbidden | 7 | El acceso a este recurso está prohibido. |
QtCoap::Error::NotFound | 8 | No se ha encontrado el recurso solicitado. |
QtCoap::Error::MethodNotAllowed | 9 | El servidor no permite el método utilizado para la URL solicitada. |
QtCoap::Error::NotAcceptable | 10 | No se ha encontrado ningún recurso que satisfaga los criterios de aceptación de la solicitud. |
QtCoap::Error::RequestEntityIncomplete | 11 | El servidor no ha recibido los bloques del cuerpo de la petición que necesita para continuar. El cliente no ha enviado todos los bloques, no los ha enviado en el orden requerido por el servidor o los ha enviado hace tanto tiempo que el servidor ya los ha descartado. |
QtCoap::Error::PreconditionFailed | 12 | Una o más condiciones dadas en los campos de la cabecera de la petición se han evaluado como falsas cuando se han comprobado en el servidor. |
QtCoap::Error::RequestEntityTooLarge | 13 | La carga útil de la solicitud es mayor de lo que el servidor está dispuesto o es capaz de procesar. |
QtCoap::Error::UnsupportedContentFormat | 14 | La carga útil está en un formato no admitido por este método en el recurso de destino. |
QtCoap::Error::InternalServerFault | 15 | El servidor se ha encontrado con una situación inesperada que le ha impedido procesar la solicitud. |
QtCoap::Error::NotImplemented | 16 | El servidor no admite la funcionalidad necesaria para procesar la solicitud. |
QtCoap::Error::BadGateway | 17 | Se ha producido un error en un servidor anterior. |
QtCoap::Error::ServiceUnavailable | 18 | El servicio no está disponible actualmente. |
QtCoap::Error::GatewayTimeout | 19 | El servidor, mientras actuaba como pasarela o proxy, no recibió una respuesta oportuna de un servidor ascendente al que necesitaba acceder para completar la solicitud. |
QtCoap::Error::ProxyingNotSupported | 20 | El servidor no puede o no quiere actuar como proxy de reenvío para el URI especificado en la opción Proxy-Uri o utilizando el esquema especificado en Proxy-Scheme. |
QtCoap::Error::Unknown | 21 | Se ha producido un error desconocido. |
enum class QtCoap::Method
Este enum especifica los métodos de solicitud CoAP.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::Method::Invalid | 0 | El método de petición por defecto para una petición vacía. |
QtCoap::Method::Get | 1 | Método GET. |
QtCoap::Method::Post | 2 | Método POST. |
QtCoap::Method::Put | 3 | Método PUT. |
QtCoap::Method::Delete | 4 | Método DELETE. |
QtCoap::Method::Other | 5 | Otro método de solicitud. |
enum class QtCoap::MulticastGroup
Este enum representa las direcciones de grupo de multidifusión CoAP definidas en RFC 7252.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::MulticastGroup::AllCoapNodesIPv4 | 0 | Dirección IPv4 "All CoAP Nodes" 224.0.1.187, del "IPv4 Multicast Address Space Registry". |
QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal | 1 | Dirección IPv6 "All CoAP Nodes" link-local scoped FF02::FD, del "IPv6 Multicast Address Space Registry". |
QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal | 2 | IPv6 "All CoAP Nodes" site-local scoped address FF05::FD, del "IPv6 Multicast Address Space Registry". |
enum QtCoap::Port
Este enum especifica los valores de puerto CoAP por defecto.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::DefaultPort | 5683 | El puerto por defecto utilizado para la transmisión no segura. |
QtCoap::DefaultSecurePort | 5684 | El puerto por defecto utilizado para la transmisión segura. |
enum class QtCoap::ResponseCode
Este enum representa el código de respuesta del protocolo CoAP, tal y como se define en RFC 7252 y RFC 7959.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::ResponseCode::EmptyMessage | 0x00 | El código de respuesta para un mensaje vacío. |
QtCoap::ResponseCode::Created | 0x41 | La solicitud se ha realizado correctamente y se han creado nuevos recursos. Este código de respuesta corresponde al HTTP 201 "Creado". |
QtCoap::ResponseCode::Deleted | 0x42 | El recurso se ha eliminado correctamente. Este código de respuesta corresponde a HTTP 204 "Sin contenido", pero sólo se utiliza en respuesta a solicitudes que hacen que el recurso deje de estar disponible, como DELETE y, en determinadas circunstancias, POST. |
QtCoap::ResponseCode::Valid | 0x43 | Este código de respuesta está relacionado con HTTP 304 "No Modificado" pero sólo se utiliza para indicar que la respuesta identificada por la entidad-tag dada en la opción ETag es válida. |
QtCoap::ResponseCode::Changed | 0x44 | El recurso se ha modificado correctamente. Este código de respuesta está relacionado con HTTP 204 "Sin contenido" pero sólo se utiliza en respuesta a solicitudes POST y PUT. |
QtCoap::ResponseCode::Content | 0x45 | La solicitud se ha realizado correctamente. Este código de respuesta corresponde a HTTP 200 "OK", pero sólo se utiliza en respuesta a solicitudes GET. |
QtCoap::ResponseCode::Continue | 0x5F | Indica que la transferencia del bloque actual se ha realizado correctamente y que el servidor enviará más bloques. |
QtCoap::ResponseCode::BadRequest | 0x-80 | No se ha reconocido la solicitud. Este código de respuesta corresponde a HTTP 400 "Bad Request". |
QtCoap::ResponseCode::Unauthorized | 0x-7f | El cliente no está autorizado a realizar la acción solicitada. Este código de respuesta corresponde al HTTP 401 "No autorizado". |
QtCoap::ResponseCode::BadOption | 0x-7e | La solicitud no ha podido ser entendida por el servidor debido a opciones no reconocidas. |
QtCoap::ResponseCode::Forbidden | 0x-7d | El acceso a este recurso está prohibido. Este código de respuesta corresponde al HTTP 403 "Prohibido". |
QtCoap::ResponseCode::NotFound | 0x-7c | No se ha encontrado el recurso solicitado. Este código de respuesta corresponde al HTTP 404 "No encontrado". |
QtCoap::ResponseCode::MethodNotAllowed | 0x-7b | El servidor no permite el método utilizado para la URL solicitada. Este código de respuesta corresponde al HTTP 405 "Método no permitido" pero sin paralelo con el campo de cabecera "Permitir". |
QtCoap::ResponseCode::NotAcceptable | 0x-7a | No se ha encontrado ningún recurso que satisfaga los criterios de aceptación de la solicitud. Este código de respuesta corresponde al HTTP 406 "No aceptable", pero sin entidad de respuesta. |
QtCoap::ResponseCode::RequestEntityIncomplete | 0x-78 | El servidor no ha recibido todos los bloques, del cuerpo de la petición, que necesita para proceder. |
QtCoap::ResponseCode::PreconditionFailed | 0x-74 | Las condiciones previas indicadas en los campos de la cabecera de la solicitud se evaluaron en false cuando se comprobaron en el servidor. Este código de respuesta corresponde a HTTP 412 "Precondition Failed". |
QtCoap::ResponseCode::RequestEntityTooLarge | 0x-73 | La carga útil de la solicitud es mayor de lo que el servidor está dispuesto o es capaz de procesar. Este código de respuesta corresponde a HTTP 413 "Request Entity Too Large". |
QtCoap::ResponseCode::UnsupportedContentFormat | 0x-72 | La carga útil está en un formato no admitido por este método en el recurso de destino. Este código de respuesta corresponde a HTTP 415 "Tipo de medio no soportado". |
QtCoap::ResponseCode::InternalServerFault | 0x-60 | El servidor ha encontrado una condición inesperada que le ha impedido satisfacer la solicitud. Este código de respuesta corresponde a HTTP 500 "Error interno del servidor". |
QtCoap::ResponseCode::NotImplemented | 0x-5f | El servidor no admite la funcionalidad necesaria para satisfacer la solicitud. Este código de respuesta corresponde a HTTP 501 "No implementado". |
QtCoap::ResponseCode::BadGateway | 0x-5e | Se ha producido un error con un servidor ascendente. Este código de respuesta corresponde a HTTP 502 "Bad Gateway". |
QtCoap::ResponseCode::ServiceUnavailable | 0x-5d | El servicio no está disponible. Este código de respuesta corresponde a HTTP 503 "Servicio no disponible". |
QtCoap::ResponseCode::GatewayTimeout | 0x-5c | El servidor, mientras actuaba como pasarela o proxy, no ha recibido una respuesta oportuna de un servidor ascendente. Este código de respuesta corresponde al HTTP 504 "Gateway Timeout". |
QtCoap::ResponseCode::ProxyingNotSupported | 0x-5b | El servidor no puede o no quiere actuar como forward-proxy para el URI especificado en la opción Proxy-Uri o utilizando el esquema especificado en Proxy-Scheme. |
QtCoap::ResponseCode::InvalidCode | 0xFF | Un código de respuesta no válido. |
enum class QtCoap::SecurityMode
Especifica el modo de seguridad utilizado para proteger una conexión CoAP, tal y como se define en RFC 7252.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::SecurityMode::NoSecurity | 0 | No hay seguridad a nivel de protocolo (DTLS está desactivado). |
QtCoap::SecurityMode::PreSharedKey | 1 | DTLS está habilitado. Se utilizará la autenticación PSK para la seguridad. |
QtCoap::SecurityMode::RawPublicKey | 2 | DTLS está activado. Se utilizará un par de claves asimétricas sin certificado (una clave pública sin procesar) para la seguridad. Este modo aún no está soportado. |
QtCoap::SecurityMode::Certificate | 3 | DTLS está activado. Se utilizará un par de claves asimétricas con un certificado X.509 para la seguridad. |
© 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.