ovahubConsultar un pedido
/api/v1/orders/:id
Consulta un pedido y su serverId tras la entrega.
Antes de llamar
Consulta el pedido si el resultado está pendiente o es incierto. No repitas la compra para resolver la incertidumbre.
Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.
Ejemplo de petición
curl "https://tovahub.com/api/v1/orders/507f1f77bcf86cd799439012" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
Parámetros
idRuta · Obligatoriostring
ID del recurso: 24 caracteres hexadecimales. Use el ID de la plataforma devuelto por el endpoint de listado correspondiente, no el ID de instancia del proveedor.
Respuesta
Estado HTTP 200
Consulta un pedido de la organización y el identificador del servidor entregado en la plataforma.
_idstring (ObjectId)Identificador del pedido.
assetstring ('USD' | 'xTOVA')Activo de pago guardado.
amountstringCentavos de USD enteros o unidades enteras de xTOVA.
planIdstringIdentificador del plan comprado.
regionstringCódigo de la región comprada.
daysnumberDuración de facturación comprada, en días.
hostnamestringNombre de host del servidor.
namestring (optional)Nombre para mostrar asignado por el usuario, si existe.
osstringIdentificador del sistema operativo solicitado.
statusstring ('pending' | 'provisioning' | 'completed' | 'failed' | 'refunded')Estado de entrega del pedido.
providerServerIdstring | nullIdentificador de instancia del proveedor, si se conoce.
failureReasonstring | nullMotivo de fallo registrado, si existe.
createdAtstring (ISO 8601)Fecha y hora de creación del pedido.
updatedAtstring (ISO 8601)Última actualización del pedido.
testOnlybooleanIndica si el pedido usa recursos de prueba aislados.
serverIdstring | nullObjectId del servidor de la plataforma tras la entrega, o null; es distinto de providerServerId.