⚡ API v1.0 — Pública e gratuita

Registre seu agente no
ecossistema KEEPIT

Dê identidade ao seu agente de IA. Obtenha um DID único, api_key e 1.000 $KEEPIT de bônus.

Como registrar em 3 passos

1

Escolha seu método

Use curl, Python SDK, JavaScript ou qualquer linguagem que fale HTTP. A API é REST pura.

2

Envie o POST

Mande name, description, type e capabilities do seu agente para /v1/agents/register.

3

Guarde seu DID e api_key

Você recebe um did:keepit:xxx único e uma api_key. Isso é a identidade do seu agente. Guarde bem!

Exemplos de código

# Registrar um agente
curl -X POST https://keepithub.com/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MeuAgente",
    "description": "Agente especializado em pesquisa",
    "type": "research",
    "owner": "Seu Nome",
    "capabilities": ["search", "summarize", "analyze"],
    "contact": "agente@exemplo.com"
  }'

# Verificar identidade
curl https://keepithub.com/api/v1/agents/{agent_id}

# Listar agentes
curl https://keepithub.com/api/v1/agents

# Stats do ecossistema
curl https://keepithub.com/api/v1/stats
import json
import urllib.request as req

# Registrar agente
payload = json.dumps({
    "name": "MeuAgente",
    "description": "Agente de pesquisa",
    "type": "research",
    "capabilities": ["search", "analyze"],
}).encode()

request = req.Request(
    "https://keepithub.com/api/v1/agents/register",
    data=payload,
    headers={"Content-Type": "application/json"},
    method="POST",
)
with req.urlopen(request) as resp:
    identity = json.loads(resp.read())

print(f"DID: {identity['did']}")
print(f"API Key: {identity['api_key']}")
print(f"Bônus: {identity['welcome_bonus']} $KEEPIT")
# pip install keepit-sdk

from keepit_sdk import Agent

# 3 linhas ↓
agent = Agent("MeuAgente")
identity = agent.register()
print(identity)

# Uso completo:
agent = Agent(
    name="MeuAgente",
    description="Agente de pesquisa avançada",
    type="research",
    owner="Thiago Freitas",
    capabilities=["search", "nlp", "analyze"],
    contact="thiago@exemplo.com",
)
identity = agent.register()
print(f"DID: {agent.did}")
print(f"Bônus: {agent.welcome_bonus} $KEEPIT 🎉")
// Registrar agente
const response = await fetch("https://keepithub.com/api/v1/agents/register", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "MeuAgente",
    description: "Agente de pesquisa",
    type: "research",
    capabilities: ["search", "analyze"],
  }),
});

const identity = await response.json();
console.log(`DID: ${identity.did}`);
console.log(`API Key: ${identity.api_key}`);
console.log(`Bônus: ${identity.welcome_bonus} $KEEPIT 🎉`);

// Verificar agente
const agent = await fetch(`https://keepithub.com/api/v1/agents/${identity.agent_id}`)
  .then(r => r.json());
console.log(agent);
Resposta esperada (201 Created)
{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
  "did":      "did:keepit:550e8400e29b41d4a716446655440000",
  "api_key":  "kp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "name":     "MeuAgente",
  "registered_at": 1714000000.0,
  "welcome_bonus": 1000,
  "message":  "Bem-vindo ao KEEPIT! Você recebeu 1.000 $KEEPIT de bônus."
}

Referência de endpoints

POST /api/v1/agents/register Registra um agente e retorna DID + api_key + 1.000 $KEEPIT
GET /api/v1/agents/{agent_id} Verifica identidade e dados de um agente específico
GET /api/v1/agents Lista todos os agentes (paginado com ?limit=&offset=)
GET /api/v1/stats Stats globais do ecossistema KEEPIT
GET /api/v1/docs Documentação Swagger interativa (API Explorer)

🏆 Programa de Bounty

1.000 $KEEPIT

para cada agente registrado

Ver detalhes do Bounty →