QtCoap Namespace
Contiene identificadores diversos que se utilizan en todo el módulo « Qt CoAP ». Más información...
| 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 el error detectado durante el procesamiento de la solicitud.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::Error::Ok | 0 | No se ha producido ningún 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 llegó 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 | El servidor no ha podido interpretar la solicitud debido a una o varias opciones no reconocidas o mal formadas. |
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 cumpla los criterios de aceptación de la solicitud. |
QtCoap::Error::RequestEntityIncomplete | 11 | El servidor no ha recibido los bloques del cuerpo de la solicitud 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 envió hace tanto tiempo que el servidor ya los ha descartado. |
QtCoap::Error::PreconditionFailed | 12 | Una o más condiciones especificadas en los campos del encabezado de la solicitud se evaluaron como falsas al comprobarlas en el servidor. |
QtCoap::Error::RequestEntityTooLarge | 13 | La carga útil de la solicitud es mayor de lo que el servidor está dispuesto a procesar o es capaz de procesar. |
QtCoap::Error::UnsupportedContentFormat | 14 | La carga útil tiene un formato no compatible con este método en el recurso de destino. |
QtCoap::Error::InternalServerFault | 15 | El servidor se ha encontrado con una condición inesperada que le ha impedido satisfacer la solicitud. |
QtCoap::Error::NotImplemented | 16 | El servidor no admite la funcionalidad necesaria para atender la solicitud. |
QtCoap::Error::BadGateway | 17 | Se ha producido un error en un servidor de nivel superior. |
QtCoap::Error::ServiceUnavailable | 18 | El servicio no está disponible en este momento. |
QtCoap::Error::GatewayTimeout | 19 | El servidor, al actuar como puerta de enlace o proxy, no recibió una respuesta a tiempo de un servidor de nivel superior al que necesitaba acceder para completar la solicitud. |
QtCoap::Error::ProxyingNotSupported | 20 | El servidor no puede o no desea 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
Esta enumeración especifica los métodos de solicitud de CoAP.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::Method::Invalid | 0 | El método de solicitud predeterminado para una solicitud 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
Esta enumeración representa las direcciones de grupos de multidifusión CoAP definidas en el RFC 7252.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::MulticastGroup::AllCoapNodesIPv4 | 0 | Dirección IPv4 «Todos los nodos CoAP» 224.0.1.187, del «Registro de espacio de direcciones de multidifusión IPv4». |
QtCoap::MulticastGroup::AllCoapNodesIPv6LinkLocal | 1 | Dirección IPv6 de ámbito local de enlace «Todos los nodos CoAP» FF02::FD, del «Registro del espacio de direcciones de multidifusión IPv6». |
QtCoap::MulticastGroup::AllCoapNodesIPv6SiteLocal | 2 | Dirección IPv6 de ámbito «local del sitio» para «Todos los nodos CoAP» FF05::FD, procedente del «Registro del espacio de direcciones de multidifusión IPv6». |
enum QtCoap::Port
Esta enumeración especifica los valores predeterminados de los puertos CoAP.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::DefaultPort | 5683 | El puerto predeterminado utilizado para la transmisión no segura. |
QtCoap::DefaultSecurePort | 5684 | El puerto predeterminado utilizado para la transmisión segura. |
enum class QtCoap::ResponseCode
Esta enumeración representa el código de respuesta del protocolo CoAP, tal y como se define en los documentos RFC 7252 y RFC 7959.
| Constante | Valor | Descripción |
|---|---|---|
QtCoap::ResponseCode::EmptyMessage | 0x00 | Código de respuesta para un mensaje vacío. |
QtCoap::ResponseCode::Created | 0x41 | La solicitud se ha realizado con éxito y ha dado lugar a la creación de nuevos recursos. Este código de respuesta se corresponde con el HTTP 201 «Created». |
QtCoap::ResponseCode::Deleted | 0x42 | El recurso se ha eliminado correctamente. Este código de respuesta se corresponde con el HTTP 204 «Sin contenido», pero solo se utiliza en respuesta a solicitudes que provocan 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 el código HTTP 304 «No modificado», pero solo se utiliza para indicar que la respuesta identificada por la etiqueta de entidad (ETag) especificada en la opción ETag es válida. |
QtCoap::ResponseCode::Changed | 0x44 | El recurso se ha modificado correctamente. Este código de respuesta se corresponde con el código HTTP 204 «Sin contenido», pero solo se utiliza en respuesta a solicitudes POST y PUT. |
QtCoap::ResponseCode::Content | 0x45 | La solicitud se ha realizado con éxito. Este código de respuesta se corresponde con el HTTP 200 «OK», pero solo 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 | La solicitud no se ha reconocido. Este código de respuesta corresponde al HTTP 400 «Solicitud incorrecta». |
QtCoap::ResponseCode::Unauthorized | 0x-7f | El cliente no está autorizado a realizar la acción solicitada. Este código de respuesta se corresponde con el HTTP 401 «No autorizado». |
QtCoap::ResponseCode::BadOption | 0x-7e | El servidor no ha podido interpretar la solicitud debido a opciones no reconocidas. |
QtCoap::ResponseCode::Forbidden | 0x-7d | El acceso a este recurso está prohibido. Este código de respuesta corresponde al código HTTP 403 «Prohibido». |
QtCoap::ResponseCode::NotFound | 0x-7c | No se ha encontrado el recurso solicitado. Este código de respuesta corresponde a 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 se corresponde con el HTTP 405 «Método no permitido», pero sin equivalente al campo de encabezado «Allow». |
QtCoap::ResponseCode::NotAcceptable | 0x-7a | No se ha encontrado ningún recurso que cumpla los criterios de aceptación de la solicitud. Este código de respuesta corresponde a 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 solicitud que necesita para continuar. |
QtCoap::ResponseCode::PreconditionFailed | 0x-74 | Las condiciones previas especificadas en los campos de encabezado de la solicitud se evaluaron como « false » al comprobarse en el servidor. Este código de respuesta se corresponde con el 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 «Entidad de solicitud demasiado grande». |
QtCoap::ResponseCode::UnsupportedContentFormat | 0x-72 | La carga útil tiene un formato no compatible con este método en el recurso de destino. Este código de respuesta se corresponde con HTTP 415 «Tipo de medio no compatible». |
QtCoap::ResponseCode::InternalServerFault | 0x-60 | El servidor se ha encontrado con 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 atender la solicitud. Este código de respuesta se corresponde con el HTTP 501 «No implementado». |
QtCoap::ResponseCode::BadGateway | 0x-5e | Se ha producido un error en un servidor de nivel superior. Este código de respuesta corresponde a HTTP 502 «Puerta de enlace incorrecta». |
QtCoap::ResponseCode::ServiceUnavailable | 0x-5d | El servicio no está disponible en este momento. Este código de respuesta corresponde a HTTP 503 «Servicio no disponible». |
QtCoap::ResponseCode::GatewayTimeout | 0x-5c | El servidor, al actuar como pasarela o proxy, no ha recibido una respuesta a tiempo de un servidor de nivel superior. Este código de respuesta corresponde a HTTP 504 «Tiempo de espera de la pasarela agotado». |
QtCoap::ResponseCode::ProxyingNotSupported | 0x-5b | El servidor no puede o no desea 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::ResponseCode::InvalidCode | 0xFF | 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 el 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 garantizar la seguridad. |
QtCoap::SecurityMode::RawPublicKey | 2 | DTLS está habilitado. Se utilizará un par de claves asimétricas sin certificado (una clave pública sin formato) para garantizar la seguridad. Este modo aún no es compatible. |
QtCoap::SecurityMode::Certificate | 3 | DTLS está activado. Se utilizará un par de claves asimétricas con un certificado X.509 para garantizar 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.