Segurança Pública
*****************

| Esta documentação tem como objetivo fornecer informações detalhadas sobre as APIs disponíveis para **Segurança Pública** recuperar os dados de um cidadão de forma segura e eficiente. Descrição das entradas e saídas de cada API. As APIs foram projetadas para atender a diferentes necessidades, proporcionando uma experiência completa e personalizada para os usuários.
|
| As APIs foram desenvolvidas com foco na segurança e privacidade das informações do cidadão. Para garantir a proteção dos dados sensíveis, todas as solicitações são processadas em ambiente criptografado, e apenas os dados estritamente necessários serão fornecidos em resposta às consultas realizadas.
|
| Lembramos que o uso indevido ou não autorizado dessas APIs pode violar as leis de proteção de dados e privacidade vigentes. Portanto, é fundamental que o acesso às informações do cidadão seja utilizado exclusivamente para fins legais e autorizados pelas respectivas autoridades.


Consulta por CPF - Entrada 
++++++++++++++++++++++++++

| A API de consulta por CPF permite a recuperação dos dados de um cidadão com base em seu Cadastro de Pessoa Física (CPF). Ao utilizar esta API, você pode realizar consultas precisas e rápidas, obtendo informações detalhadas sobre o indivíduo em questão, contendo tanto dados textuais como também dados binários (imagens em base64).

.. code-block:: html

   https://api.mj.gov.br/idnacional/pf/cidadaos/{cpf}


cpf (String)
   | Campo que contém o Número Único do Processo.
   | O Número Único do Processo não pode ser maior que 11 caracteres; Deve ser alfa numéricos; E deve ser único (não estar sendo utilizado por outra identidade na base de dados).


Consulta por CPF - Saida
++++++++++++++++++++++++


.. code-block:: json
	
	{
		"hits": {
			"hits": [
				{
					"_source": {
						"enderecocidadao": "Blablabla",
						"filiacao12abreviada": "FLAVIO SOARES DA SILVA",
						"filiacao21": "FLAVIO SOARES DA SILVA",
						"estadoemissao": "Distrito Federal",
						"versoidentidade": "iVBORw0KGgoAAAANSUhEUgAAAZUAAALQCAYAAABYJu15AACAAElEQVR4Xuy9B5hdV3kunAaE...",
						"flagautismo": false,
						"cpf": "02887318160",
						"situacao": 1,
						"filiacao31": "FLAVIO SOARES DA SILVA",
						"nome1": "Jessica Aquino",
						"filiacao11abreviada": "FLAVIO SOARES DA SILVA",
						"certidaonasccasamento": "Certd cas 14591409 Fls 59243014 Liv 8959115",
						"nome2": null,
						"cns": "456",
						"enderecoresponsavel": "Groove Street",
						"filiacao32abreviada": "FLAVIO SOARES DA SILVA",
						"filiacao12cpf": "83848371472",
						"filiacao31abreviada": "FLAVIO SOARES DA SILVA",
						"frenteidentidade": "iVBORw0KGgoAAAANSUhEUgAAAZUAAALQCAYAAABYJu15AACAAElEQVR4Xuy997dtW1Xvef6Aaq2q1Q...",
						"uuid": "cf648887-9230-416c-b1f0-38544a816131",
						"ctps": "123",
						"flagdeficienciaauditiva": false,
						"naturalidade": "RECIFE/PE",
						"orgaoexpedidor2": "teste",
						"telefonecidadao": "12345678910110",
						"filiacao22abreviada": "FLAVIO SOARES DA SILVA",
						"cid": "123456",
						"telefoneresponsavel": "01101987654321",
						"datanascimento": "1979-07-06",
						"nomesocial1": "Jessica Aquino",
						"observacaosaude": "Estresse",
						"orgaoexpedidor1": "SDS/PE",
						"datavalidade": "2033-07-26",
						"filiacao32cpf": "83848371472",
						"qrcode": "iVBORw0KGgoAAAANSUhEUgAAAtAAAALQCAYAAAC5V0ecAACAAElEQVR4XuydbWpkV5a1u4oGzUEmp1FCHoV5q5rULO...",
						"ufemissao": "GO",
						"rgs": "[{\"nrRG\":\"123456\",\"nmUF\":\"RN\",\"dtEmissao\":\"2022-11-14\"},{\"nrRG\":\"654321\",\"nmUF\":\"MG\",\"dtEmissao\":\"2022-11-14\"},{\"nrRG\":\"987654\",\"nmUF\":\"SP\",\"dtEmissao\":\"2022-11-14\"}]",
						"flagdeficienciafisica": false,
						"cnh": "678",
						"pispasep": "29354",
						"nomeresponsavel": "Carl Johnson",
						"cddedo": null,
						"nome1abreviado": "Jessica Aquino",
						"filiacao21cpf": "83848371472",
						"flagdeficienciaintelectual": false,
						"nit": "6754",
						"foto": "iVBORw0KGgoAAAANSUhEUgAAAoAAAALWCAMAAADhxNL7AAAACXBIWXMAAC4jAAAuIwF4pT92AAABBVBMVEX...",
						"tituloeleitor": "78964039",
						"sexo": "F",
						"localemissao": null,
						"estadocivil": "Casado(a)",
						"nome2abreviado": null,
						"tiponacionalidade": "Nato",
						"filiacao11": "FLAVIO SOARES DA SILVA",
						"filiacao32": "FLAVIO SOARES DA SILVA",
						"cidadeemissao": "Goiânia",
						"polegardireito": "/6D/qAB6TklTVF9DT00gOQpQSVhfV0lEVEggODAwClBJWF9IRUlHSFQgODAwClBJWF9ERVBUSCA4ClBQSSA1MDAK...",
						"nacionalidade": "BRA",
						"nis": "4432",
						"filiacao11cpf": "83848371472",
						"flagdeficienciavisual": false,
						"filiacao22": "FLAVIO SOARES DA SILVA",
						"validadeciptea": "2023-07-19T00:00:00.000Z",
						"filiacao22cpf": "83848371472",
						"nomesocial2": null,
						"cpfresponsavel": "83848371472",
						"emailresponsavel": "email@responsavel.com",
						"filiacao21abreviada": "FLAVIO SOARES DA SILVA",
						"filiacao12": "FLAVIO SOARES DA SILVA",
						"filiacao31cpf": "83848371472",
						"tiposanguineo": "A+",
						"dataemissao": "2023-07-26",
						"orgaoemissor": "Secretaria de Segurança Pública"
					}
				}
			]
		}
	}

.. include:: seguranca-publica-saida-default.rst

foto (String)
	| Campo **base64** que contém a foto do cidadão.
	| No formato **png ou jpeg**.

frenteidentidade (String)
	| Campo **base64** que contém a frente da identidade digital do cidadão.
	| No formato **png**.

versoidentidade (String)
	| Campo **base64** que contém a frente da identidade digital do cidadão.
	| No formato **png**.

qrcode (String)
	| Campo **base64** que contém o qr code com os dados do cidadão.
	| No formato **png**.

polegardireito (String)
	| Campo **base64** que contém a foto do polegar direito do cidadão.
	| No formato **wsq**.
 

Recuperar por Dados Avançados - Entrada 
+++++++++++++++++++++++++++++++++++++++

| A API de consulta por Dados Avançados permite a recuperação dos dados de um cidadão com base no nome, filiação e data de nascimento. Ao utilizar esta API, você pode realizar consultas precisas e rápidas, obtendo informações detalhadas sobre o indivíduo em questão, contendo tanto dados textuais como binários (imagens em base64).

.. code-block:: html

   https://api.mj.gov.br/idnacional/pf/cidadaos


.. code-block:: json
	
	{
		"nome": "Jessica",
		"dataNascimento": "06/07/1979",
		"filiacao1": "FLAVIO SOARES",
		"filiacao2": "FLAVIO SOARES",
		"from": 0,
		"size": 10
	}

nome (String, Obrigatório)
   | Campo que recebe o nome do cidadão.

dataNascimento (String, Obrigatório)
   | Campo que recebe o nome do cidadão.

filiacao1 (String, Obrigatório)
   | Campo que recebe uma filiação do cidadão.

filiacao2 (String, Opcional)
   | Campo que recebe uma filiação do cidadão.

from (String, Obrigatório)
   | Campo que recebe o início da lista paginada de cidadão que atendem os requisitos (nome / filiação / data de nascimento).
   | Deve ser maior ou igual a zero

size (String, Obrigatório)
   | Campo que recebe o fim da lista paginada de cidadão que atendem os requisitos (nome / filiação / data de nascimento).
   | Deve ser maior que zero e menor ou igual a 100


Recuperar por Dados Avançados - Saída
+++++++++++++++++++++++++++++++++++++


.. code-block:: json
	
	{
		"hits": {
			"hits": [
				{
					"_source": {
						"enderecocidadao": "Blablabla",
						"filiacao12abreviada": "FLAVIO SOARES DA SILVA",
						"filiacao21": "FLAVIO SOARES DA SILVA",
						"estadoemissao": "Distrito Federal",
						"flagautismo": false,
						"cpf": "02887318160",
						"situacao": 1,
						"filiacao31": "FLAVIO SOARES DA SILVA",
						"nome1": "Jessica Aquino",
						"filiacao11abreviada": "FLAVIO SOARES DA SILVA",
						"certidaonasccasamento": "Certd cas 14591409 Fls 59243014 Liv 8959115",
						"nome2": null,
						"cns": "456",
						"enderecoresponsavel": "Groove Street",
						"filiacao32abreviada": "FLAVIO SOARES DA SILVA",
						"filiacao12cpf": "83848371472",
						"filiacao31abreviada": "FLAVIO SOARES DA SILVA",
						"uuid": "cf648887-9230-416c-b1f0-38544a816131",
						"ctps": "123",
						"flagdeficienciaauditiva": false,
						"naturalidade": "RECIFE/PE",
						"orgaoexpedidor2": "teste",
						"telefonecidadao": "12345678910110",
						"filiacao22abreviada": "FLAVIO SOARES DA SILVA",
						"cid": "123456",
						"telefoneresponsavel": "01101987654321",
						"datanascimento": "1979-07-06",
						"nomesocial1": "Jessica Aquino",
						"observacaosaude": "Estresse",
						"orgaoexpedidor1": "SDS/PE",
						"datavalidade": "2033-07-26",
						"filiacao32cpf": "83848371472",
						"ufemissao": "GO",
						"rgs": "[{\"nrRG\":\"123456\",\"nmUF\":\"RN\",\"dtEmissao\":\"2022-11-14\"},{\"nrRG\":\"654321\",\"nmUF\":\"MG\",\"dtEmissao\":\"2022-11-14\"},{\"nrRG\":\"987654\",\"nmUF\":\"SP\",\"dtEmissao\":\"2022-11-14\"}]",
						"flagdeficienciafisica": false,
						"cnh": "678",
						"pispasep": "29354",
						"nomeresponsavel": "Carl Johnson",
						"cddedo": null,
						"nome1abreviado": "Jessica Aquino",
						"filiacao21cpf": "83848371472",
						"flagdeficienciaintelectual": false,
						"nit": "6754",
						"tituloeleitor": "78964039",
						"sexo": "F",
						"localemissao": null,
						"estadocivil": "Casado(a)",
						"nome2abreviado": null,
						"tiponacionalidade": "Nato",
						"filiacao11": "FLAVIO SOARES DA SILVA",
						"filiacao32": "FLAVIO SOARES DA SILVA",
						"cidadeemissao": "Goiânia",
						"nacionalidade": "BRA",
						"nis": "4432",
						"filiacao11cpf": "83848371472",
						"flagdeficienciavisual": false,
						"filiacao22": "FLAVIO SOARES DA SILVA",
						"validadeciptea": "2023-07-19T00:00:00.000Z",
						"filiacao22cpf": "83848371472",
						"nomesocial2": null,
						"cpfresponsavel": "83848371472",
						"emailresponsavel": "email@responsavel.com",
						"filiacao21abreviada": "FLAVIO SOARES DA SILVA",
						"filiacao12": "FLAVIO SOARES DA SILVA",
						"filiacao31cpf": "83848371472",
						"tiposanguineo": "A+",
						"dataemissao": "2023-07-26",
						"orgaoemissor": "Secretaria de Segurança Pública"
					}
				}
			]
		}
	}


.. include:: seguranca-publica-saida-default.rst

.. include:: uuid.rst