API Reference

A API pública do Tartini permite integrar funcionalidades de inteligência artificial e base de conhecimento a sistemas externos: chatbots, CRMs, aplicações web e mais.

Base URL

Todas as requisições devem ser feitas para:

https://api-talk.saninternet.com/v1

Autenticação

Todas as requisições exigem uma API key válida enviada no header Authorization:

Authorization: Bearer pyp_live_SUA_API_KEY

API keys são geradas no Dashboard em Configurações > API Keys. Veja o guia completo em Autenticação.

Endpoints disponíveis

GET /api/status

Verifica se a API está operacional e valida sua API key.

POST /api/rag/retrieve

Busca chunks relevantes e gera respostas com IA.

Formato de resposta

Todas as respostas são retornadas em JSON. Em caso de erro:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid or expired API key"
}

Códigos de status

Código	Descrição
`200`	Sucesso
`401`	API key ausente, inválida ou expirada
`403`	Assinatura inativa (`SubscriptionInactive`)
`422`	Erro de validação no corpo da requisição

Visão geral

Conceitos

Endpoints

Base URL

Autenticação

Endpoints disponíveis

GET /api/status

POST /api/rag/retrieve

Formato de resposta

Códigos de status

​Base URL

​Autenticação

​Endpoints disponíveis

GET /api/status

POST /api/rag/retrieve

​Formato de resposta

​Códigos de status

Base URL

Autenticação

Endpoints disponíveis

Formato de resposta

Códigos de status