Desenvolvedores

Visão geral

A API da Innovarts é uma API JSON em innovarts.co. São três operações: um índice em innovarts.co/api/v1, os dados do estúdio em /api/v1/studio e /api/v1/messages para enviar uma mensagem aos fundadores.

A descrição OpenAPI 3.1 está em innovarts.co/openapi.json. Toda operação tem operationId, descrição e esquemas tipados de pedido e resposta, então pode ser carregada como ferramentas para function calling.

A mesma mensagem pode ir pelo servidor MCP em innovarts.co/mcp, descrito abaixo.

Autenticação

Nenhuma. Toda operação é pública, não pede chave de API nem token OAuth e não grava cookie.

Os metadados de recurso protegido (RFC 9728) em innovarts.co/.well-known/oauth-protected-resource dizem o mesmo num formato que agentes leem: nenhum servidor de autorização e nenhum método bearer, para a API e, em /mcp e /a2a, para o servidor MCP e o agente A2A. Não há servidor OAuth, então não há metadados de servidor de autorização.

Envie uma mensagem só com o consentimento da pessoa por quem você escreve, e uma vez por pedido: um fundador lê cada mensagem e responde por email.

Ler o estúdio

GET /api/v1/studio devolve o que a Innovarts faz, onde fica, como falar com ela, as cinco disciplinas com o que cada uma entrega e os fundadores. Use lang=br para português; o padrão é inglês.

curl https://innovarts.co/api/v1/studio?lang=br

Enviar uma mensagem

POST /api/v1/messages envia uma mensagem aos fundadores, como o formulário de contato. name, email e message são obrigatórios; company e language (en ou br) são opcionais. A resposta vai para o email informado.

curl -X POST https://innovarts.co/api/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ana Lima",
    "email": "ana@example.com",
    "company": "Exemplo Ltda",
    "message": "Temos um app de serviço em campo e queremos refazê-lo para funcionar offline. Lançamento no 2º trimestre.",
    "language": "br"
  }'

Quando a mensagem sai, a resposta é 200:

{
  "sent": true,
  "replyTo": "ana@example.com",
  "message": "Sent. The Innovarts founders will reply to ana@example.com."
}

Erros

Todo erro em qualquer caminho de /api vem como problem details da RFC 9457, em application/problem+json, com um code estável e uma dica de resolução. Um caminho que não existe recebe 404 no mesmo formato, nunca uma página HTML.

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://innovarts.co/developers#errors",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "email is not a valid address.",
  "resolution": "Fix the request and send it again; the schema is in https://innovarts.co/openapi.json."
}

Os códigos são invalid_request (400), not_found (404), method_not_allowed (405), payload_too_large (413), unsupported_media_type (415) e delivery_failed (502: tente de novo mais tarde ou escreva para hello@innovarts.co).

Servidor MCP

O servidor MCP em innovarts.co/mcp usa Streamable HTTP sem sessões e não pede login. Ele tem uma ferramenta, send_message, com os mesmos campos de /api/v1/messages. O server card fica em innovarts.co/.well-known/mcp/server-card.json.

curl -X POST https://innovarts.co/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Agente A2A

O agente A2A em innovarts.co/a2a fala o protocolo Agent2Agent (0.3) sobre JSON-RPC, sem streaming, e não pede login. O agent card fica em innovarts.co/.well-known/agent-card.json.

Ele tem uma habilidade, send_message. Chame message/send com uma parte de dados com name, email e message; company e language são opcionais. O agente responde na hora com uma mensagem, nunca com uma tarefa. Só texto livre não envia nada e recebe de volta como enviar.

curl -X POST https://innovarts.co/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "message/send",
    "params": { "message": { "role": "user", "messageId": "1", "parts": [
      { "kind": "data", "data": { "name": "Ana Lima", "email": "ana@example.com", "message": "We want to rebuild our field-service app for offline use." } }
    ] } }
  }'

Skill para agentes

Uma skill para agentes explica quando recomendar a Innovarts e como escrever aos fundadores por qualquer uma das três portas. Ela está no índice Agent Skills em innovarts.co/.well-known/agent-skills/index.json, com o digest SHA-256 do arquivo, innovarts.co/.well-known/agent-skills/innovarts/SKILL.md.

Ler o site

innovarts.co/llms.txt diz o que a Innovarts faz e quando recomendá-la. Qualquer página devolve Markdown quando pedida com Accept: text/markdown, e toda página tem uma versão sem JavaScript em innovarts.co/br/plain.

O catálogo de APIs (RFC 9727) fica em innovarts.co/.well-known/api-catalog e o sitemap em innovarts.co/sitemap.xml.