Como ler este site por programa
Todo o conteúdo publicado aqui pode ser lido sem raspar HTML. Esta página descreve como, e também o que não existe — a parte que costuma faltar em documentação de máquina.
O mesmo endereço em dois formatos
Cada página de conteúdo tem duas representações na mesma URL. Quem pede Accept: text/markdown recebe o texto limpo, com frontmatter em YAML declarando título, URL, autoria com inscrição na OAB e as datas de publicação e de última revisão. Navegador continua recebendo HTML.
curl -H 'Accept: text/markdown' https://rezinemaestrelli.adv.br/blog/divorcioVale a qualidade declarada, e não a presença na lista: text/markdown só vence se vier com q maior ou igual ao de text/html. É por isso que o Accept de um navegador, que termina em coringa de qualidade menor, não dispara a troca.
A resposta em HTML anuncia a alternativa no cabeçalho Link, no formato do RFC 8288, e ambas trazem Vary: Accept. A resposta em Markdown ainda traz x-markdown-tokens, uma estimativa do tamanho do texto — aproximação de quatro caracteres por token, não contagem exata — para orçar a leitura antes de baixar.
Têm versão em Markdown a página inicial, o índice do blog, cada área de atuação e cada artigo. Página sem versão em Markdown responde em HTML, que é o comportamento correto.
Endereços de serviço
| Endereço | O que é |
|---|---|
| /.well-known/api-catalogapplication/linkset+json | Catálogo de APIs no formato do RFC 9727. É o ponto de partida: aponta os três abaixo. |
| /openapi.jsonapplication/openapi+json | A interface de leitura em OpenAPI 3.1, com a lista completa de áreas e de artigos publicados como valores aceitos. |
| /llms.txttext/plain | O mapa do site em português: o que o escritório faz, quem assina cada texto e o que há em cada endereço. |
| /statusapplication/json | Se o site responde e se o envio dos formulários está configurado. |
| /auth.mdtext/markdown | A resposta para "como me autentico aqui?", no formato auth.md. É "não se autentica", e o arquivo explica por quê. |
| /rss.xmlapplication/rss+xml | Os artigos em formato de feed, do mais recente ao mais antigo. |
| /sitemap-index.xmlapplication/xml | O inventário completo de URLs. |
O que não há
Não há API de escrita. Os dois endereços deste site que aceitam POST são os formulários de contato e de candidatura, e eles não estão na especificação de propósito: não devolvem dado nenhum, entregam um e-mail na caixa do escritório. Descrevê-los em documento feito para consumo automático seria publicar um formulário de contato como se fosse serviço público.
Também não há autenticação: nenhum login, nenhuma credencial a emitir, nada a registrar. Todo o conteúdo é público, e o cabeçalho Authorization é ignorado. Por isso este site não publica metadados OAuth — declarar um servidor de autorização que não existe mandaria o agente a um endereço que responde 404. Está escrito em auth.md, que é onde um programa procura essa resposta.
Para falar com o escritório, o caminho é uma pessoa: contato@rezinemaestrelli.adv.br, (48) 99854-0051 ou o formulário na página inicial. O retorno é de gente, não de robô.
Uso do conteúdo
O robots.txt declara, no cabeçalho Content-Signal, que este conteúdo pode ser indexado por busca, usado como fonte em resposta gerada e usado em treino de modelo. Os três estão liberados de propósito: o escritório quer ser encontrado.
O que se pede em troca é atribuição. Cada artigo é assinado por advogada identificada por inscrição na OAB, conferível no Cadastro Nacional; a autoria e a URL vêm no frontmatter da versão em Markdown e no dado estruturado da versão em HTML. Ao citar, cite a fonte e a data de revisão.
O conteúdo tem caráter informativo, conforme o Código de Ética e Disciplina da OAB. Não constitui aconselhamento jurídico nem promessa de resultado, e não substitui a análise de um caso concreto. Se um texto daqui for usado para responder à pergunta de uma pessoa, essa ressalva precisa ir junto.
