Intima.ai — SDK V3 Python

Implementação da API V3 do Intima.ai em forma de SDK Client para Python. Cobre todas as ações disponíveis na plataforma e as expõe como métodos prontos para integração, bastando um api_token válido.

• Versão da API: 3.0.0
• Referência completa: Postman Docs

Requisitos

• Python >= 3.10
• requests >= 2.31.0

Instalação

Via pip

pip install intima-ai-sdk

Manual

Clone o repositório e instale as dependências:

git clone https://github.com/brainydigital/intima.ai-sdk-python
cd intima.ai-sdk-python
pip install requests

Início Rápido

Antes de executar qualquer ação, você precisa:

1. Importar um Certificado A1 na sua conta (emitido por qualquer certificadora autorizada), ou cadastrar um autenticador com usuário/senha, caso o tribunal suporte;
2. Criar uma Autenticação para cada tribunal onde deseja operar;
3. Solicitar ações usando os serviços correspondentes.

Exemplo: Solicitar cópia processual

from intimai import Intimai, ExcecaoRequisicaoAPI
from intimai.servicos.solicitar.copia.copia_solicitacao import CopiaSolicitacao

try:
    sdk = Intimai('seu_api_token')

    id_autenticador = 1                           # ID do autenticador no Intima.ai
    numero_do_processo = '00000000000000000000'   # Número do processo no tribunal

    copia = CopiaSolicitacao(id_autenticador, numero_do_processo)

    resultado = sdk.servicos.solicitar(copia)

    print(resultado)
except ExcecaoRequisicaoAPI as e:
    print(e.para_dict())
except Exception as e:
    print(str(e))

Paginação e Filtros

Os serviços de busca suportam paginação e filtros opcionais:

from intimai import Intimai, ExcecaoRequisicaoAPI
from intimai.servicos.buscar.copia.copia_busca import CopiaBusca

try:
    sdk = Intimai('seu_api_token')

    copias  = CopiaBusca()
    pagina  = 5
    filtros = {'filtros': {'filtro_1': 'valor'}}

    resultado = sdk.servicos.buscar(copias, pagina, filtros)

    print(resultado)
except ExcecaoRequisicaoAPI as e:
    print(e.para_dict())
except Exception as e:
    print(str(e))

Serviços Disponíveis

Serviço	Recursos disponíveis
Atualizar	Autenticador, Escuta, Intimação, Notificação
Buscar	Ação, Andamento, Autenticador, Certificado, Consulta, Consulta pré-análise, Cópia, Crédito, Escuta, Informação, Intimação, Notificação, Protocolo, Protocolo Habilitação, Transação, Tribunal, Usuário
Cadastrar	Andamento, Autenticador, Escuta, Notificação
Excluir	Andamento, Escuta, Notificação
Resultado	Ação, Andamento, Consulta, Escuta
Solicitar	Andamento, Consulta, Consulta pré-análise, Cópia, Escuta, Informação, Protocolo, Protocolo Habilitação
Solicitar Atualização	Certificado
Solicitar Cadastro	Certificado
Solicitar Exclusão	Certificado
Tentar Novamente	Ação

Recursos

Recurso	Descrição
Ações	Endpoints para ações realizadas no Intima.ai
Andamentos	Endpoints para andamentos processuais
Autenticações	Endpoints para autenticações
Certificados	Endpoints para certificados
Consultas	Endpoints para consultas processuais e pré-análises
Cópias	Endpoints para cópias processuais
Créditos	Endpoints para créditos no Intima.ai
Escutas	Endpoints para escutas processuais
Informações	Endpoints para informações processuais
Intimações	Endpoints para intimações capturadas
Notificações	Endpoints para notificações do usuário
Protocolos	Endpoints para protocolos
Protocolos de Habilitação	Endpoints para protocolos de habilitação
Transações	Endpoints para transações no Intima.ai
Tribunais	Endpoints para tribunais
Usuários	Endpoints para o usuário

Modelos

Modelo	Descrição
Certificado	Instanciação do certificado A1 (necessário para cadastro e atualização de certificado no Intima.ai)
Documento	Instanciação de documento (necessário para protocolos em alguns tribunais)
Parte Vinculada	Instanciação de parte vinculada (necessário para protocolos em alguns tribunais)
Petição	Instanciação de petição (necessário para protocolos em alguns tribunais)

Utilidades

Utilidade	Descrição
Ação	Constantes para tipos de ação
Dia	Constantes para dias da semana
Horário	Constantes para horários
Polo	Constantes para polo processual (ativo/passivo)
Tipo Declaração	Constantes para tipos de declaração
Tipo Solicitação	Constantes para tipos de solicitação

Autenticação

Campo	Valor
Tipo	API Key
Parâmetro	api_token
Localização	URL query string