Saltar al contenido principal

Método para descargar el JSON (DownloadDocumentJson)

Este método permite descargar el archivo XML de un documento utilizando el servicio GET DownloadDocumentJson.

Por medio de este método, se obtiene el archivo JSON codificado en base 64 del documento consultado.

Para conectarse a esta funcionalidad será necesario que ingrese la URL de acuerdo con el ambiente a consumir:

PRODUCCIÓNhttps://developers.gosocket.net/api/v1/File/DownloadDocumentJson
SANDBOXhttps://developers-sbx.gosocket.net/api/v1/File/DownloadDocumentJson

¿Cómo funciona el método DownloadDocumentJson?

Para realizar la petición, el método tiene los siguientes parámetros:

DownloadDocumentJson (request)
ParámetroTipoDescripciónValores permitidos
globalDocumentId*StringIdentificación de documento en Gosocket.UUID de 36 caracteres alfanuméricos xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type*StringTipo de Json a descargar. En la respuesta se mostrará el tipo definido.default: descarga el Json del documento.

*Requerido


Ejemplo de petición

image-20240503-023451.png

Nota: Recuerde que antes de utilizar el método, debe realizar su autenticación dentro de la pestaña Authorization.

Al ser un método GET, utilizamos la pestaña Params en Postman para formar el query.

  1. Seleccione el tipo de método. En este caso, se debe seleccionar GET.
  2. Ingrese la URL del método.
  3. Ingrese los parámetros que se muestran en la tabla anterior con sus valores correspondientes.
  4. Presione Send.

Ejemplo de respuesta

image-20240503-023615.png

Para interpretar correctamente la respuesta de la API, tome en cuenta los siguientes criterios:

DownloadDocumentJson (response)
ParámetroTipoDescripciónValores permitidos
NameStringNombre del archivo Json descargadoglobalDocumentId.json
DescriptionStringDescripción del evento realizado.JsonContent for paramétro_type GlobalDocumentId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Base64ContentStringArchivo Json codificado en base 64
TimeStampStringFecha y hora de creación del documentoaaaa-mm-ddThh:mm:ss
TypeStringTipo de archivo“json”

Una vez que se decodificó la respuesta, se mostrará el contenido del documento en el lenguaje de la decodificación.

image-20240503-024817.png