order_details

QUERY

https://www.digicert.com/services/v2/reports/query

Use esta consulta a fin de obtener información concreta sobre todos los pedidos de certificados.

Para obtener información concreta sobre un pedido de certificado único, use la consulta order_details_by_id.

GraphQL

{
    order_details(valid_till:"2020-10-26",limit:5,sort:["valid_from","DESC"]) {
        id
        common_name
        dns_names
        organization_id
        status
        valid_from
        valid_till
    }
}

200 OK

{
    "data": {
        "order_details": [
            {
                "id": "123456",
                "common_name": "digicert.com",
                "dns_names": null,
                "organization_id": "112233",
                "status": "issued",
                "valid_from": "2019-10-04",
                "valid_till": "2020-10-08"
            },
            {
                "id": "123458",
                "common_name": "dev.digicert.com",
                "dns_names": null,
                "organization_id": "223344",
                "status": "issued",
                "valid_from": "2019-10-03",
                "valid_till": "2020-10-07"
            },
            {
                "id": "123443",
                "common_name": "example.com",
                "dns_names": "sub.example.com,www.example.com",
                "organization_id": "112233",
                "status": "revoked",
                "valid_from": "2019-10-02",
                "valid_till": "2020-10-06"
            },
            {
                "id": "123460",
                "common_name": "example.net",
                "dns_names": "www.example.net",
                "organization_id": "112233",
                "status": "issued",
                "valid_from": "2019-09-30",
                "valid_till": "2020-10-07"
            },
            {
                "id": "123424",
                "common_name": "example.org",
                "dns_names": "test.example.org,monitor.example.org,api.example.org",
                "organization_id": "334455",
                "status": "issued",
                "valid_from": "2019-09-27",
                "valid_till": "2020-10-01"
            }
        ]
    }
}

Argumentos

Incluya argumentos de consulta para filtrar, buscar o manipular información. Separe los diversos argumentos con comas. Salvo ordenar,, todos los argumentos tienen un formato clave:valor (por ejemplo, status:"issued").

Filtros

Use argumentos de filtros para acotar la información que surge de la consulta con los valores de parámetros determinados. Puede usar muchos filtros para acotar aún más los resultados.

Nombre	Solicitud/opción	Tipo	Descripción
id	opcional	int	Id. del pedido.
status	opcional	string	Estado del pedido. Vea Glosario: estado del pedido
valid_from	opcional	string	Fecha en la que comienza la validez del certificado. Formato: `yyyy-MM-dd` Operador: `>=`
valid_till	opcional	string	Fecha en la que termina la validez del certificado. Formato: `yyyy-MM-dd` Operador: `<=`
container_id	opcional	string	Id. de contenedor.
organization_id	opcional	string	Id. de organización.
product_name_id	opcional	string	Id. de nombre del producto. Vea Glosario: identificadores de productos
serial_number	opcional	string	Número de serie del certificado.
signature_hash	opcional	string	Cifrado de firma usado para firmar la solicitud de certificado.
user_id	opcional	string	Id. del usuario que hizo el pedido.
date_created	opcional	string	Fecha en la que se hizo el pedido. Formato: `yyyy-MM-dd HH:mm:ss` Operador: `>=`
ca_cert_id	opcional	string	Id. de la autoridad de certificado emisora.
common_name	opcional	string	Nombre que el certificado protege. Use `%` para un operador like (por ejemplo, `common_name:"%example.com"`).
dns_names	opcional	string	Lista de nombres adicionales que el certificado protege.
locale	opcional	string	Configuración regional del pedido. Vea Glosario: códigos de configuración regional
thumbprint	opcional	string	Huella digital del certificado.
email	opcional	string	Correo electrónico del pedido del cliente.

Buscar

Use el argumento de búsqueda para encontrar una cadena determinada contenida en los campos en los que se hizo la búsqueda.

Nombre	Solicitud/opción	Tipo	Descripción
search	opcional	string	Busque campos concretos en la cadena incluida. Use `%` para un operador like (por ejemplo, `search:"%example.com"`). Campos en los que se hizo la búsqueda: `id`, `status`, `container_id`, `organization_id`, `product_name_id`, `additional_emails`, `organization_name`, `product_name`, `serial_number`, `user_id`, `common_name`, `email`

Orden y paginación

Use los argumentos de orden y paginación para manipular los resultados de consulta que se devuelven.

Nombre	Solicitud/opción	Tipo	Descripción
ordenar	opcional	matriz	Indique el campo ordenar y la dirección. Formato: `["{{field}}","{{direction}}"]` *Valores permitidos (campo):* `valid_till`, `container_id`, `organization_id`, `product_name_id`, `serial_number`, `signature_hash`, `user_id`, `date_created`, `ca_cert_id`, `common_name`, `dns_names`, `locale`, `thumbprint`, `email` *Valores permitidos (dirección):* `ASC`, `DESC` Predeterminado: `["id","DESC"]`
offset	opcional	int	Comenzar lista en el número especificado para la paginación. Predeterminado: `0`
limit	opcional	int	Truncar lista para el número especificado para la paginación. Máx.: `1000`(predeterminado)

Campos

Debe incluir al menos un campo en la solicitud. Si no se envían campos, se devolverá un error de sintaxis.

Si no existe información para el campo, se devuelve un valor de null.

Nombre	Tipo	Descripción
account_id	string	Id. de la cuenta vinculada con el pedido.
additional_emails	string	Direcciones de correo electrónico adicionales que figuran en el pedido.
agreement_id	string	Id. de la CSA acordada.
auto_renew	string	Especifique si el certificado debe renovarse automáticamente. Posibles valores: `0` (deshabilitada), `1` (habilitada)
ca_cert_id	string	Id. de la autoridad de certificado emisora.
certificate_tracker_id	string	Id. de certificado.
common_name	string	Nombre que el certificado protege.
contacts_email	string	Dirección de correo electrónico del contacto de la organización.
container_id	string	Id. del contenedor del pedido.
container_name	string	Nombre del contenedor del pedido.
cost	string	Costo del pedido.
csr	string	Solicitud de firma del certificado (CSR).
custom_renewal_message	string	Mensaje personalizado incluido en las notificaciones de renovación.
customer_order_id	string	Id. del pedido del cliente.
date_created	string	Fecha en la que se hizo el pedido. Formato: `yyyy-MM-dd HH:mm:ss`
dcv_method	string	Método de validación de control de dominio configurado para el dominio. Vea Glosario: método DCV
disable_issuance_email	string	Especifica si se envían los correos electrónicos de emisión. Posibles valores: `0` (falso), `1` (verdadero)
disable_renewal_notifications	string	Especifica si las notificaciones de renovación están habilitadas. Posibles valores: `0` (falso), `1` (verdadero)
dns_names	string	Lista separada por comas de nombres adicionales con protección por el certificado.
email	string	Si el certificado tiene una dirección de correo electrónico incrustada (por ejemplo, certificados del cliente), devuelve la dirección de correo electrónico en el certificado.
firstname	string	Nombre del contacto de la organización.
has_duplicates	int	Especifica si el certificado tiene duplicados. Posibles valores: `0` (falso), `1` (verdadero)
id	string	Id. del pedido.
is_out_of_contract	string	Estado del contrato del pedido. Posibles valores: `0` (falso), `1` (verdadero)
is_renewed	string	Especifica si el pedido se ha renovado. Posibles valores: `0` (falso), `1` (verdadero)
issuer_common_name	string	Nombre descriptivo de la autoridad de certificado emisora.
job_title	string	Cargo del contacto de la organización.
lastname	string	Apellido del contacto de la organización.
locale	string	Configuración regional del pedido. Vea Glosario: códigos de configuración regional
metadatos	cadena	Detalles de los campos personalizados. Formato: `{{metadata_id}}` `{{metadata_label}}` `{{metadata_value}}`Separador de datos: `0x1f`
org_addr1	string	Dirección de la organización.
org_addr2	string
organization_city	string	Ciudad donde se encuentra la organización.
organization_country	string	País donde se encuentra la organización.
organization_id	string	Id. de la organización vinculada con el pedido.
organization_name	string	Nombre de la organización.
organization_state	string	Estado donde se encuentra la organización.
organization_unit	string	Unidades de organización que figuran en el certificado.
pay_type	string	Método de pago usado para el pedido. Posibles valores: `A` (saldo de la cuenta), `C` (tarjeta de crédito)
plus_feature	string	Especifica si la función más está habilitada para el pedido. Posibles valores: `0` (deshabilitada), `1` (habilitada)
product_id	string	Id. del producto.
product_name	string	Mostrar nombre del producto. Vea Glosario: identificadores de productos
product_name_id	string	Id. de nombre del producto. Vea Glosario: identificadores de productos
product_type	string	Tipos de producto. Vea Glosario: tipos de productos
purchased_dns_names	string	Cantidad de SAN adicionales adquiridos.
receipt_id	string	Id. del recibo.
Renewed	string	Especifica si el pedido se ha renovado. Posibles valores: `FALSE`, `TRUE`
renewed_order_id	string	Id. del pedido anterior. Solo se devuelve si el pedido es una renovación.
serial_number	string	Número de serie del certificado.
serversw	string	Id. de plataforma del servidor. Vea Glosario: plataformas de servidores
signature_hash	string	Cifrado de firma usado para firmar la solicitud de certificado.
status	string	Estado del pedido. Vea Glosario: estado del pedido
telephone	string	Número de teléfono del contacto de la organización.
thumbprint	string	Huella digital del certificado.
user_assignments	string	Id. del usuario asignado al pedido.
user_email	string	Dirección de correo electrónico del usuario que solicitó el certificado.
user_first_name	string	Nombre del usuario que solicitó el certificado.
user_id	string	Id. del usuario que hizo el pedido.
user_last_name	string	Apellido del usuario que solicitó el certificado.
valid_from	string	Fecha en la que comienza la validez del certificado. Formato: `yyyy-MM-dd`
valid_till	string	Fecha en la que termina la validez del certificado. Formato: `yyyy-MM-dd`
validity_years	string	La cantidad de años durante los que el certificado es válido.

Parámetros de la respuesta

Nombre	Tipo	Descripción
data	object	Contenedor para la información de la consulta que se devuelve.
.. order_details	array	Lista de objetos de pedidos que contienen campos consultados.
.. .. {{campo}}	-	Campo y valor consultados. Campos devueltos que dependen de la consulta enviada.

Argumentos

Filtros

Buscar

Orden y paginación

Campos

Parámetros de la respuesta

Acerca de nosotros