💡A API PETI - Programa de Erradicação do Trabalho Infantil consulta informações sobre os benefícios concedidos pelo governo brasileiro às famílias de crianças e adolescentes em situação de trabalho infantil. O programa proporciona transferências de renda e atividades socioeducativas, sendo essencial para análise de risco e compliance.
Introdução
A API PETI - Programa de Erradicação do Trabalho Infantil permite obter dados sobre os benefícios concedidos no âmbito do Programa PETI, incluindo informações sobre transferências de renda, municípios beneficiados e status das famílias inscritas.
URL Base
A API está hospedada no seguinte endereço:
https://api.directd.com.br
Endpoint
Consulta PETI - Programa de Erradicação do Trabalho Infantil
GET /api/PETITrabalhoInfantil
Descrição: Endpoint para consultar os benefícios do PETI.
Nota: Esta consulta não gera comprovantes.
Autenticação
Para acessar esta API, é necessário fornecer um token de autenticação.
Regras de Autenticação:
- O token deve ser enviado como parâmetro na URL da requisição.
- O token é obrigatório para realizar consultas.
Campos da API
Dados Gerais
- CPF: CPF da pessoa beneficiária.
- NIS: Número de Identificação Social do beneficiário.
- Nome: Nome completo do beneficiário.
Benefícios
- Número do Registro: Identificador único do benefício.
- Data: Data de concessão do benefício.
- Situação: Status atual do benefício.
- Valor: Valor concedido no benefício.
- Município: Cidade onde o benefício foi concedido.
- UF: Unidade Federativa (estado) do município.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| CPF | string | Não | CPF da pessoa beneficiária. |
| NIS | string | Não | Número de Identificação Social. |
| TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
Exemplos de Requisição
Usando cURL
curl 'https://api.directd.com.br/api/PETITrabalhoInfantil?CPF=12345678909&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "PETI - Programa de Erradicação do Trabalho Infantil",
"consultaUid": "peti-123456",
"usuario": "Maria Silva",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 150
},
"retorno": {
"nome": "JOÃO DA SILVA",
"nis": "12345678901",
"cpf": "123.456.789-09",
"beneficios": [
{
"numeroRegistro": 1001,
"data": "2023-11-15",
"situacao": "Ativo",
"valor": "R$ 150,00",
"municipio": "São Paulo",
"uf": "SP"
},
{
"numeroRegistro": 1002,
"data": "2024-01-10",
"situacao": "Ativo",
"valor": "R$ 150,00",
"municipio": "São Paulo",
"uf": "SP"
}
]
}
}
9. Erros Comuns
| Código | Descrição |
|---|---|
| 400 | Requisição inválida: parâmetros incorretos. |
| 401 | Não autenticado: token inválido ou ausente. |
| 403 | Não autorizado: saldo insuficiente para realizar a consulta. |
| 404 | Não encontrado: registro não localizado. |
| 408 | Tempo esgotado: consulta não foi concluída no prazo. |
| 500 | Erro interno: falha no processamento da consulta. |
| 503 | Serviço em manutenção: indisponível temporariamente. |
10. Notas Importantes
- Os dados obtidos são úteis para compliance e análise de risco.
- Informe apenas um único CPF ou NIS por requisição.
- Certifique-se de ter saldo suficiente para realizar consultas.