Breadcrumbs

Identificador físico

Requisitos del proceso:

El token debe ser generado

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.