## Antecedentes Criminais / SP
Emite Atestado de Antecedentes no Instituto de Identificação Ricardo Gumbleton Daunt (IIRGD), órgão da Secretaria da Segurança Pública de São Paulo. Este serviço funciona com Carteiras de Identidade (RG) emitidas em São Paulo. IMPORTANTE - O não fornecimento do Atestado de Antecedentes Criminais não implica a existência de pendências jurídico-criminais.


### URL do site
- https://www2.ssp.sp.gov.br/aacweb/carrega-formulario

### Requisição
URL para POST: `https://api.infosimples.com/api/v2/consultas/antecedentes-criminais/sp`



| Parâmetro       | Descrição                                                                                                                                                                                                                                                                                                         |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token*          | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta.                                                                                                                                                                                                          |
| nome*           | Nome da Pessoa a ser consultada.                                                                                                                                                                                                                                                                                  |
| birthdate*      | Data de nascimento no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido.                                                                                                   |
| genero*         | Gênero do indivíduo. Valores possíveis são <strong>MASCULINO</strong> ou <strong>FEMININO</strong>.                                                                                                                                                                                                               |
| rg**            | Número do RG, sem dígito final.                                                                                                                                                                                                                                                                                   |
| rg_digito**     | Dígito final do RG. Este é o dígito de controle.                                                                                                                                                                                                                                                                  |
| rg_expedicao**  | Data de expedição do RG no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido.                                                                                              |
| cin_cpf**       | Número da CIN (CPF). Deve ser informado caso o documento utilizado seja a Carteira de Identidade Nacional (CIN).                                                                                                                                                                                                  |
| cin_expedicao** | Data de expedição da CIN no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. Deve ser informado caso o documento utilizado seja a Carteira de Identidade Nacional (CIN). |
| pai**           | Nome do pai do indivíduo. Apesar de opcional, recomenda-se o preenchimento.                                                                                                                                                                                                                                       |
| mae**           | Nome da mãe do indivíduo. Apesar de opcional, recomenda-se o preenchimento.                                                                                                                                                                                                                                       |

> * Parâmetro obrigatório.

> ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente.


### Exemplos de respostas (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "service": "antecedentes-criminais/sp",
    "parameters": {
      "nome": "Nome de Exemplo",
      "birthdate": "1111-11-11",
      "genero": "MASCULINO",
      "rg": "21274123",
      "rg_digito": "2",
      "rg_expedicao": "2010-03-05",
      "pai": "Nome de Exemplo",
      "mae": "Nome de Exemplo"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.24",
    "requested_at": "2019-07-23T16:59:29.000-03:00",
    "elapsed_time_in_milliseconds": 1054,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX19G1VAGFlHLsyVpsg4fcnwDs4aQXvz+wM7bixUav85vIOvwwnJzoX+0+hTvbAHL4fe84x2H0mx7sQ=="
  },
  "data_count": 1,
  "data": [
    {
      "atestado_codigo": "",
      "conseguiu_emitir_certidao_negativa": false,
      "emissao_datahora": "",
      "mensagem": "",
      "normalizado_emissao_datahora": "",
      "site_receipt": "https://api.infosimples.com/receipt/exemplo-de-url"
    }
  ],
  "site_receipts": [
    "https://api.infosimples.com/receipt/exemplo-de-url"
  ]
}
```


### Arquivo de visualização de consulta

O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API é **emitido pela fonte original**.

### Exemplos de códigos para integração com a API


#### Python
```python
# Testado com: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/antecedentes-criminais/sp'
args = {
  "nome":          "VALOR_DO_PARAMETRO_NOME",
  "birthdate":     "VALOR_DO_PARAMETRO_BIRTHDATE",
  "genero":        "VALOR_DO_PARAMETRO_GENERO",
  "rg":            "VALOR_DO_PARAMETRO_RG",
  "rg_digito":     "VALOR_DO_PARAMETRO_RG_DIGITO",
  "rg_expedicao":  "VALOR_DO_PARAMETRO_RG_EXPEDICAO",
  "cin_cpf":       "VALOR_DO_PARAMETRO_CIN_CPF",
  "cin_expedicao": "VALOR_DO_PARAMETRO_CIN_EXPEDICAO",
  "pai":           "VALOR_DO_PARAMETRO_PAI",
  "mae":           "VALOR_DO_PARAMETRO_MAE",
  "token":         "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO",
  "timeout":       "300"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

if response_json['code'] == 200:
  print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
  mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
  mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
  mensagem += "; ".join(response_json['errors'])
  print(mensagem)

print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```


## Estamos prontos para ajudar
Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.