Développeurs

Vue d'ensemble

L'API Innovarts est une API JSON sur innovarts.co. Elle compte trois opérations : un index sur innovarts.co/api/v1, les faits du studio sur /api/v1/studio, et /api/v1/messages pour envoyer un message aux fondateurs.

La description OpenAPI 3.1 se trouve sur innovarts.co/openapi.json. Chaque opération a un operationId, une description et des schémas typés de requête et de réponse, pour pouvoir être chargée comme outil de function calling.

Le même message peut être envoyé par le serveur MCP sur innovarts.co/mcp, décrit ci-dessous.

Authentification

Aucune. Chaque opération est publique, ne demande ni clé d'API ni jeton OAuth, et ne pose aucun cookie.

Les métadonnées de ressource protégée (RFC 9728) sur innovarts.co/.well-known/oauth-protected-resource disent la même chose sous une forme que les agents lisent : pas de serveur d'autorisation ni de méthode bearer, pour l'API et, sous /mcp et /a2a, pour le serveur MCP et l'agent A2A. Il n'y a pas de serveur OAuth, donc pas de métadonnées de serveur d'autorisation.

N'envoyez un message qu'avec le consentement de la personne concernée, et une seule fois par demande : un fondateur lit chaque message et répond par e-mail.

Lire le studio

GET /api/v1/studio renvoie ce que fait Innovarts, où il se trouve, comment le joindre, ses cinq disciplines avec ce que chacune livre, et les fondateurs. Ajoutez lang=br pour le portugais ; l'anglais est la langue par défaut.

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

La réponse, abrégée :

{
  "name": "Innovarts",
  "locale": "en",
  "url": "https://innovarts.co/",
  "location": { "city": "São Paulo", "country": "Brazil" },
  "contact": { "email": "hello@innovarts.co", "api": "https://innovarts.co/api/v1/messages", "mcp": "https://innovarts.co/mcp" },
  "disciplines": [
    { "key": "strategy", "name": "Strategy", "headline": "A plan before any code.", "deliverables": ["A written scope", "A roadmap with milestones", "The first release, defined"] }
  ],
  "founders": [{ "name": "Gabriel Souza", "role": "Co-founder · product, UX and frontend" }]
}

Envoyer un message

POST /api/v1/messages envoie un message aux fondateurs, comme le formulaire de contact. name, email et message sont obligatoires ; company et language (en ou br) sont facultatifs. La réponse est envoyée à l'e-mail indiqué.

curl -X POST https://innovarts.co/api/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ana Lima",
    "email": "ana@example.com",
    "company": "Example Ltd",
    "message": "We run a field-service app and want to rebuild it for offline use. Launch in Q2.",
    "language": "en"
  }'

Une fois envoyé, la réponse est 200 :

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

Erreurs

Chaque erreur sur chaque chemin /api est un problem details RFC 9457, servi en application/problem+json, avec un code stable et une piste de résolution. Un chemin inexistant reçoit un 404 de la même forme, jamais une page 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."
}

Les codes sont invalid_request (400), not_found (404), method_not_allowed (405), payload_too_large (413), unsupported_media_type (415) et delivery_failed (502, réessayez plus tard ou écrivez à hello@innovarts.co).

Serveur MCP

Le serveur MCP sur innovarts.co/mcp parle Streamable HTTP sans sessions et ne demande aucune connexion. Il a un seul outil, send_message, avec les mêmes champs que /api/v1/messages. Sa carte de serveur se trouve sur 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"}'

Agent A2A

L'agent A2A sur innovarts.co/a2a parle le protocole Agent2Agent (0.3) en JSON-RPC, sans streaming, et ne demande aucune connexion. Sa carte d'agent se trouve sur innovarts.co/.well-known/agent-card.json.

Il a une seule compétence, send_message. Appelez message/send avec une partie data contenant name, email et message ; company et language sont facultatifs. L'agent répond aussitôt par un message, jamais par une tâche. Du texte libre seul n'envoie rien et renvoie la marche à suivre.

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." } }
    ] } }
  }'

Compétence d'agent

Une compétence pour agents explique quand recommander Innovarts et comment écrire aux fondateurs par l'une des trois portes. Elle figure dans l'index Agent Skills sur innovarts.co/.well-known/agent-skills/index.json, avec l'empreinte SHA-256 de son fichier, innovarts.co/.well-known/agent-skills/innovarts/SKILL.md.

Lire le site

innovarts.co/llms.txt dit ce que fait Innovarts et quand le recommander. Toute page renvoie du Markdown lorsqu'elle est demandée avec Accept: text/markdown, et chaque page a une version sans JavaScript sous innovarts.co/plain.

Le catalogue d'API (RFC 9727) se trouve sur innovarts.co/.well-known/api-catalog et le plan du site sur innovarts.co/sitemap.xml.