🔓 Desbloquear signatário

POST/document/unlockchave privadaprk_

Este serviço permite gerenciar signatários bloqueados durante o processo de validação de identidade, tanto para documentos quanto para pacotes. Ele permite aprovar, rejeitar, reiniciar ou cancelar o processo dos signatários que foram bloqueados pelo sistema de segurança.

info

Este serviço se aplica somente a signatários que estão em estado bloqueado durante a validação de identidade.

---

Autenticação

Inclua sua chave privada no cabeçalho Authorization.

Authorization: prk_xxx...

---

Parâmetros de criação

Nome	Tipo	Descrição
code	String obrigatório	Código do documento ou pacote concatenado com o ID do signatário (ex.: DOCUMENTCODEID ou PACKAGECODEID)
email	String obrigatório	E-mail do usuário da organização que aprova ou rejeita o participante bloqueado
status	String obrigatório	Ação a executar: approve, reject, reset, cancel
message	String condicional	Nota ou motivo do aprovador. Obrigatório quando status é approve ou cancel. Não aceito para reject ou reset

nota

O campo code identifica tanto documentos quanto pacotes: é o código do documento (ou do pacote) concatenado com o ID do signatário bloqueado. O sistema detecta automaticamente o tipo de processo.

Ações disponíveis

• approve: Aprova a validação de identidade do signatário (requer o campo message)
• reject: Rejeita a validação de identidade do signatário
• reset: Reinicia o processo (aplica-se apenas à assinatura por WhatsApp; caso contrário, funciona igual a reject)
• cancel: Cancela o processo de assinatura (requer o campo message)

---

🧪 Exemplos de uso

Aprovar signatário bloqueado

curl

curl --location 'https://api.auco.ai/v1.5/ext/document/unlock' \
--header 'Authorization: prk_private_key_company' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "DOCUMENTCODEID",
    "email": "approver@auco.ai",
    "status": "approve",
    "message": "Identidade verificada com sucesso"
}'

Python

import requests
import json

url = "https://api.auco.ai/v1.5/ext/document/unlock"

payload = json.dumps({
  "code": "DOCUMENTCODEID",
  "email": "approver@auco.ai",
  "status": "approve",
  "message": "Identidade verificada com sucesso"
})
headers = {
  'Authorization': 'prk_private_key_company',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Node.js

const axios = require('axios');
let data = JSON.stringify({
  code: 'DOCUMENTCODEID',
  email: 'approver@auco.ai',
  status: 'approve',
  message: 'Identidade verificada com sucesso',
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.auco.ai/v1.5/ext/document/unlock',
  headers: {
    Authorization: 'prk_private_key_company',
    'Content-Type': 'application/json',
  },
  data: data,
};

axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

Aprovar um signatário de pacote

Para pacotes, o campo code é o código do pacote concatenado com o ID do signatário.

curl

curl --location 'https://api.auco.ai/v1.5/ext/document/unlock' \
--header 'Authorization: prk_private_key_company' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "PACKAGECODEID",
    "email": "approver@auco.ai",
    "status": "approve",
    "message": "Identidade verificada com sucesso"
}'

Python

import requests
import json

url = "https://api.auco.ai/v1.5/ext/document/unlock"

payload = json.dumps({
  "code": "PACKAGECODEID",
  "email": "approver@auco.ai",
  "status": "approve",
  "message": "Identidade verificada com sucesso"
})
headers = {
  'Authorization': 'prk_private_key_company',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Node.js

const axios = require('axios');
let data = JSON.stringify({
  code: 'PACKAGECODEID',
  email: 'approver@auco.ai',
  status: 'approve',
  message: 'Identidade verificada com sucesso',
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.auco.ai/v1.5/ext/document/unlock',
  headers: {
    Authorization: 'prk_private_key_company',
    'Content-Type': 'application/json',
  },
  data: data,
};

axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

Cancelar processo com motivo

curl

curl --location 'https://api.auco.ai/v1.5/ext/document/unlock' \
--header 'Authorization: prk_private_key_company' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "DOCUMENTCODEID",
    "email": "approver@auco.ai",
    "status": "cancel",
    "message": "Tentativa de fraude detectada"
}'

Python

import requests
import json

url = "https://api.auco.ai/v1.5/ext/document/unlock"

payload = json.dumps({
  "code": "DOCUMENTCODEID",
  "email": "approver@auco.ai",
  "status": "cancel",
  "message": "Tentativa de fraude detectada"
})
headers = {
  'Authorization': 'prk_private_key_company',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Node.js

const axios = require('axios');
let data = JSON.stringify({
  code: 'DOCUMENTCODEID',
  email: 'approver@auco.ai',
  status: 'cancel',
  message: 'Tentativa de fraude detectada'
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.auco.ai/v1.5/ext/document/unlock',
  headers: {
    Authorization: 'prk_private_key_company',
    'Content-Type': 'application/json',
  },
  data: data,
};

axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

---

Exemplos de resposta

Resposta bem-sucedida

{
  "message": "OK"
}

---

⚠️ Respostas de erro

Código	Descrição
400	Parâmetros ausentes, validações não aplicáveis, ID do signatário ausente no código (MISSING_SIGNER_ID) ou processo não bloqueado (NOT_BLOCKED_PROCESS)
401	Autenticação inválida ou ausente