Breadcrumbs

Identificador físico

Pré-requisitos do processo:

O token deve ser gerado

URL base

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

Autorização

Todos os endpoints devem enviar o token no cabeçalho da requisição

JSON
Authorization: Bearer token

Exemplo de autorização:

JSON
Authorization: Bearer 089d22caa3f6d338239a14AuU09R3FZJWk4XhMHAAbXIkQw3oydFUF8VFlP0QkHI=

Card Codes

Este endpoint retorna os identificadores físicos do usuário.

POST

JSON
api/v1/users/card-codes

Corpo da requisição: Os parâmetros a seguir devem ser incluídos no corpo da requisição como dados JSON.

  • LogonName (string)

  • DomainName (string)

Exemplo de requisição:

JSON
POST api/v1/card-codes
Content-Type: application/json

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

Resposta de sucesso: Se a requisição for bem-sucedida, você receberá uma resposta com o status 200 OK com os identificares físicos do usuário.

Exemplo de resposta:

JSON
Status: 200 OK
Content-Type: application/json

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

Respostas de erro:

  • Status 400 Bad Request: O usuário não foi encontrado.

Add Card code

Este endpoint adiciona o identificador físico do usuário.

POST

JSON
api/v1/users/add-card-code

Corpo da requisição: Os parâmetros a seguir devem ser incluídos no corpo da requisição como dados JSON.

  • LogonName (string)

  • DomainName (string)

  • ReplaceUniqueCardCode (boolean)

Se quantidade de códigos de cartões dos usuários estiver configurada como Utilizar somente um código de cartão por usuário:

True: Se o usuário possuir um identificador cadastrado ele será substituído

False: Não substitui o identificador físico

  • CardCode (string)

Exemplo de requisição:

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

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

Resposta de sucesso: Se a requisição for bem-sucedida, você receberá uma resposta com o status 200 OK com o identificador atualizado (caso o parâmetro ReplaceUniqueCardCode tenha sido enviado como true).

Exemplo de resposta:

JSON
Status: 200 OK
Content-Type: application/json

true

Respostas de erro:

  • Status 400 Bad Request: A requisição está faltando o corpo ou algum parâmetro necessário.

  • Status 400 Bad Request: O usuário não foi encontrado.

  • Status 400 Bad Request: Código está sendo usado por outro usuário.