PIN y PIN Seguro

Pré-requisitos do processo:

URL base

JSON

https://integration-360-api.nddprint.com/integration-360-api

Autorización

Todos los endpoints deben enviar el token en el encabezado de la petición.

JSON

Authorization: Bearer token

Ejemplo de autorización:

JSON

Authorization: Bearer 089d22caa3f6d338239a14AuU09R3FZJWk4XhMHAAbXIkQw3oydFUF8VFlP0QkHI=

PIN Codes

Este endpoint devuelve el PIN y PIN seguro del usuario.

POST

JSON

api/v1/users/pin-codes

Cuerpo de la petición: Los siguientes parámetros deben ser incluidos en el cuerpo de la petición como datos JSON.

LogonName (string)
DomainName (string)

Ejemplo de petición:

JSON

POST api/v1/pin-codes
Content-Type: application/json

{
  "LogonName": "usuario123",
  "DomainName": "dominio123"
}

Respuesta exitosa: Si la solicitud tiene éxito, recibirá una respuesta con el status 200 OK con el PIN y el PIN seguro del usuario.

Ejemplo de respuesta:

JSON

Status: 200 OK
Content-Type: application/json

{
    "pinCode": "1231231",
    "securePinCode": "12345",
    "useSecurePinCode": true
}

Respuestas de error:

Status 400 Bad Request: No se encontró el usuario.

Update Pin code auto renew

Este endpoint actualiza automáticamente el PIN del usuario.

Para que este endpoint funcione correctamente, la forma de administrar los códigos PIN debe configurarse en Renovación automática del PIN.

POST

JSON

api/v1/users/update-pin-code-autorenew

Cuerpo de la petición: Los siguientes parámetros deben ser incluidos en el cuerpo de la petición como datos JSON.

LogonName (string)
DomainName (string)

Ejemplo de petición:

JSON

POST api/v1/update-pin-code-autorenew
Content-Type: application/json

{
  "LogonName": "usuario123",
  "DomainName": "dominio123"
}

Respuesta exitosa: Si la petición tiene éxito, recibirá una respuesta con el status 200 OK con el valor del PIN.

Ejemplo de respuesta:

JSON

Status: 200 OK
Content-Type: application/json

0208

Respuestas de error:

Status 403 Forbidden: La configuración no está habilitada en el NDD Print Portal 360.

Update Secure PIN Code

Este endpoint actualiza el PIN seguro del usuario.

POST

JSON

api/v1/users/update-secure-pin-code

Cuerpo de la petición: Los siguientes parámetros deben ser incluidos en el cuerpo de la petición como datos JSON.

LogonName (string)
DomainName (string)
UseSecurePinCode (boolean)
SecurePinCode (string)

Ejemplo de petición:

JSON

POST api/v1/pin-codes
Content-Type: application/json

{
  "LogonName": "usuario123"
  "DomainName": "dominio123"
  "UseSecurePinCode": true
  "SecurePinCode": "123456"
}

Respuesta exitosa: Si la petición tiene éxito, recibirá una respuesta con el status200 OK con un valor booleano (true o false).

Ejemplo de respuesta:

JSON

Status: 200 OK
Content-Type: application/json

true

Respuestas de error:

Status 400 Bad Request: No se encontró el usuario.