Recursos para desenvolvedores

Documentação de API, OpenAPI, autenticação, MCP e recursos para agents da UnifAPI

Um ponto de entrada rastreável para desenvolvedores e AI agents que procuram a superfície de desenvolvedores da UnifAPI pelo nome. Comece por aqui para acesso HTTP direto, configuração de MCP, metadados de OAuth, manifestos de registry e código de Skill.

Especificação OpenAPI

HTTP direto

Chame rotas de dados públicos com uma chave de API de workspace. As respostas usam um único envelope JSON com dados, paginação, cobrança e erros tipados.

GET /x/tweets/search/recent?q=unifapi HTTP/1.1
Host: api.unifapi.com
Authorization: Bearer $UNIFAPI_API_KEY

MCP

Dê a um agent ferramentas de dados públicos ao vivo através do servidor MCP Streamable HTTP hospedado. O OAuth é o caminho de autenticação recomendado.

Connector URL:
https://mcp.unifapi.com

Tools:
list_operations
get_operation
call_api

Autenticação de agents

Os agents devem ler o auth.md e os metadados de recurso protegido antes de pedir segredos ao usuário.

GET /auth.md
GET https://mcp.unifapi.com/.well-known/oauth-protected-resource
URLs previsíveis

Tudo o que um agent deve conseguir encontrar

Esses recursos incluem o nome do produto em títulos e cabeçalhos para que buscas diretas pelo nome dos recursos para desenvolvedores da UnifAPI tenham uma única página de destino explícita.

Documentação de API

Guias de API legíveis por humanos, documentação de autenticação, limites de taxa e páginas de endpoints geradas.

Especificação OpenAPI

Contrato público OpenAPI 3.1 gerado a partir dos metadados de rota da UnifAPI.

URL base da API

Host de API HTTP de produção para chamadas diretas de dados públicos.

Servidor MCP

Configuração do servidor MCP Streamable HTTP hospedado. URL do conector: https://mcp.unifapi.com.

Endpoint de perguntas NLWeb

Envie consultas em linguagem natural via POST com JSON _meta/results no estilo NLWeb, ou solicite SSE com prefer.streaming.

Suporte a streaming

MCP Streamable HTTP, eventos SSE em /ask e comportamento de JSON REST direto.

Versionamento e descontinuação

Política de ciclo de vida da API REST, descontinuação e adivinhação de caminhos, legível por agents.

Desenvolvimento de agents e orientações de sandbox

Caminhos de teste seguros, demos de ferramentas gratuitas, orientações de validação em baixo volume e limites de sandbox.

auth.md

Guia de manuseio de credenciais legível por agents para OAuth de MCP e fallback de chave de API.

Diretório de HTTP Message Signatures

Política atual legível por máquina: não suportado; use OAuth ou autenticação bearer por chave de API.

Metadados de recurso protegido por OAuth

Metadados de recurso OAuth para clientes de MCP.

Manifesto de registry de MCP

Nome, ícone, descrição, repositório e remote hospedado para registries de MCP.

Listagem no registry MCP.so

Listagem da UnifAPI em diretório de MCP de terceiros com um backlink para unifapi.com.

Índice de Agent Skills

Índice de descoberta para os artefatos de Skill open-source da UnifAPI.

Skills open-source

Código de Skill público para ambientes de general-agent, research-agent e coding-agent.

SDKs de cliente

SDKs de cliente gerados para TypeScript, Python, Go, Java, C#, PHP, Ruby e Swift, cada um em seu próprio repositório `unifapi-sdk-*`.

Criar chave de API

Faça login e crie uma chave de API de workspace para acesso HTTP direto.

SDKs de cliente

SDKs de cliente gerados para TypeScript, Python, Go, Java, C#, PHP, Ruby, and Swift — cada um em seu próprio repositório unifapi-sdk-*, gerados a partir da especificação OpenAPI da UnifAPI. Use-os quando um fluxo de trabalho de agent evolui para código de produto, monitoramento agendado ou automação de backend.

npm install @unifapi/sdk
Ver SDKs no GitHub

Host de produção

As chamadas HTTP diretas usam https://api.unifapi.com. As rotas seguem o conjunto de operações OpenAPI gerado. Os clientes de MCP devem preferir https://mcp.unifapi.com.