Servicio web REST

En caso de decidir utilizar el servicio web REST directamente, indicar que todas las llamadas son de tipo POST y es necesario incluir como cabecera las claves CompanyId e InstallationId con el valor suministrado por los administradores de SDH.

Hemos documentado las llamadas a la API REST caso usando curl, pero si tu lenguaje de programación te permite llamar a la API usando clases del estilo a HttpWebRequest, HttpClient,..., entonces deberías usarlas.

curl -X POST https://apitest.solmicrosdh.com/xxxxxxxx \
    --cert /ruta/al/certificado.pfx \
    --cert-type P12 \
    --pass mypfxpassword \
  -H "Content-Type: application/json" \
  -H "CompanyId: guid-unico-empresa" \
  -H "InstallationId: guid-unico-instalacion" \
  -d '{ 
    ... JSON del formato canónico
   }'

Postman ⬇️

Puedes realizar pruebas de llamadas a la API REST usando por ejemplo Postman.

Proporcionamos ejemplos en el archivo SDH.postman_collection.json que debes descomprimir.

Utilizar la aplicación de escritorio de Postman, y configurarla:

1. Seleccionar ⚙️ Settings

2. Seleccionar la pestaña Certificates
   

3. Client certificates Add Certificate...

   1. Host: apitest.solmicrosdh.com
   2. Seleccionar un certificado válido en la web de SDH, desde el apartado Clientes para las claves CompanyId e InstallationId.
   3. Passphrase: Contraseña del certificado
   4. Add

4. Pulsar el botón Import
   

   1. Arrastrar el archivo descomprimido de los ejemplos (SDH.postman_collection.json)
      

   2. El resultado es:
      

5. Probar las operaciones