Identificador físico

Requisitos del proceso:

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=

Card Codes

Este endpoint devuelve los identificadores físicos del usuario.

POST

JSON

api/v1/users/card-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/card-codes
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 los identificadores físicos del usuario.

Ejemplo de respuesta:

JSON

Status: 200 OK
Content-Type: application/json

{
    "uniqueCardCode": true,
    "cardCodes": [
        "123456789"
    ]
}

Respuestas de error:

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

Add Card code

Este endpoint agrega el identificador físico del usuario.

POST

JSON

api/v1/users/add-card-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)
ReplaceUniqueCardCode (boolean)

Si la cantidad de códigos de tarjetas de los usuarios está configurada en Usar solo un código de tarjeta por usuario:

True: Si el usuario tiene un identificador registrado será reemplazado

False: No sustituye al identificador físico

CardCode (string)

Ejemplo de petición:

JSON

POST api/v1/add-card-code
Content-Type: application/json

{
  "LogonName": "usuario123",
  "DomainName": "dominio123",
  "ReplaceUniqueCardCode": true,
  "CardCode": "ABC123456"
}

Respuesta exitosa: Si la petición tiene éxito, recibirá una respuesta con el status 200 OK con el identificador actualizado (si el parámetro ReplaceUniqueCardCode se ha enviado como true).

Ejemplo de respuesta:

JSON

Status: 200 OK
Content-Type: application/json

true

Respuestas de error:

Status 400 Bad Request: La petición está faltando el cuerpo o algún parámetro necesario.
Status 400 Bad Request: No se encontró el usuario.
Status 400 Bad Request: El código está siendo utilizado por otro usuario.