PIN and Secure PIN

Process prerequisites:

The token must be generated

URL base

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

Authorization

All endpoints must send the token in the request header.

Authorization: Bearer token

Authorization example:

Authorization: Bearer 089d22caa3f6d338239a14AuU09R3FZJWk4XhMHAAbXIkQw3oydFUF8VFlP0QkHI=

PIN Codes

This endpoint returns the user's PIN and Secure PIN.

POST

api/v1/users/pin-codes

Request Body: The following parameters must be included in the request body as JSON data.

• LogonName (string)

• DomainName (string)

Example of request:

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

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

Success response: If the request is successful, you will receive a response with a status of 200 OK with the user's PIN and Secure PIN.

Example answer:

Status: 200 OK
Content-Type: application/json

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

Error responses:

• Status 400 Bad Request: The user was not found.

Update Pin code auto renew

This endpoint automatically updates the user's PIN.

For this endpoint to work correctly, the way to manage PIN codes must be set to Automatic renewal of the PIN.

POST

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

Request Body: The following parameters must be included in the request body as JSON data.

• LogonName (string)

• DomainName (string)

Example of request:

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

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

Success response: If the request is successful, you will receive a response with status 200 OK with the PIN value.

Example answer:

Status: 200 OK
Content-Type: application/json

0208

Error responses:

• Status 403 Forbidden: The setting is not enabled in NDD Print Portal 360.

Update Secure PIN Code

This endpoint updates the user's Secure PIN.

POST

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

Request Body: The following parameters must be included in the request body as JSON data.

• LogonName (string)

• DomainName (string)

• UseSecurePinCode (boolean)

• SecurePinCode (string)

Example of request

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

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

Success Response: If the request is successful, you will receive a response with status 200 OK with a boolean value (true or false).

Example answer:

Status: 200 OK
Content-Type: application/json

true

Error responses:

• Status 400 Bad Request: The user was not found.

{{component-feedback-article}}