Visão geral
A Quicknode disponibiliza APIs que permitem aos programadores, aos agentes de IA e às aplicações baseadas em LLM interagir com a infraestrutura de blockchain e gerir a infraestrutura das aplicações de forma programática. Estas APIs disponibilizam dados de blockchain, fluxos de eventos em tempo real, serviços de armazenamento e funcionalidades de gestão de infraestrutura.
- Todas as APIs do Quicknode utilizam protocolos padrão (HTTP, JSON-RPC, REST, gRPC, WebSocket); qualquer agente de IA pode aceder-lhes diretamente
- Os agentes têm duas formas de aceder ao Quicknode apenas com uma carteira com saldo:
- Pagamento por solicitação (ou através de créditos): Utilize o x402 ou o MPP para aceder aos pontos finais da API Core da blockchain sem necessidade de conta, pagando por cada chamada ou utilizando o saldo de créditos
- Criar uma conta completa: utilize as Subscrições de Agente para efetuar o pagamento através de x402 ou MPP e receba instantaneamente uma chave API completa da plataforma, que desbloqueia o conjunto completo de produtos Quicknode (pontos de extremidade RPC, Streams, Webhooks, SQL Explorer, Key-Value Store, API de administração) num plano
- Utilize o LLM-Optimized Docs para a descoberta, o Blockchain Skills para um conhecimento preciso das APIs e o Quicknode MCP para gerir a infraestrutura através da linguagem natural
APIs do Quicknode
Todas as APIs dos produtos Quicknode são pontos de extremidade padrão HTTP, JSON-RPC, REST, gRPC e WebSocket que qualquer cliente, incluindo agentes de IA, pode chamar diretamente:
- API principal: Ler dados da blockchain, enviar transações e consultar o estado dos contratos em todas as redes suportadas através de RPC, REST e gRPC.
- API Streams: Crie e faça a gestão de pipelines de dados em tempo real da blockchain para indexação, análise e monitorização de eventos.
- API de Webhooks: Configure notificações baseadas em eventos, acionadas por atividades específicas na cadeia de blocos.
- API do SQL Explorer: Executar consultas SQL em dados indexados na cadeia de blocos através de REST.
- API de armazenamento de chave-valor: Ler e gravar o estado da aplicação com um armazenamento leve e sem servidor.
- API de administração: Faça a gestão programática de pontos de extremidade, utilização, segurança, faturação e permissões da equipa.
- API do IPFS: Fixar e recuperar ficheiros no IPFS através do gateway Quicknode.
Capacidades dos agentes de IA
Os agentes de IA interagem normalmente com as APIs do Quicknode utilizando uma combinação de ferramentas que os ajudam a encontrar documentação, a gerar pedidos corretos, a autenticar o acesso e a gerir a infraestrutura.
| Capacidade | Ferramenta | O que permite |
|---|---|---|
| Descubra as APIs | Documentos otimizados para LLM | Encontre a documentação correta do Quicknode e os métodos da API |
| Aprender sobre APIs | Competências em blockchain | Gerar pedidos e código corretos para a API do Quicknode |
| Autenticar | Chave API / Pagamentos Agentic (x402, MPP) | Efetuar pedidos à infraestrutura da Quicknode |
| Gerir a infraestrutura | Quicknode MCP | Gerir terminais e infraestrutura através da API de administração |
| Infraestrutura de abastecimento | Subscrições de agentes | Efetue o pagamento via x402/MPP para criar uma conta Quicknode, receber uma chave API completa da plataforma e aceder a toda a plataforma |
Descubra APIs com documentação otimizada para LLM
A Quicknode publica Índices de documentação otimizados para LLM (llms.txt) em toda a plataforma. Estes índices permitem que os sistemas de IA localizem documentação relevante sobre métodos RPC, parâmetros de API, configuração de infraestrutura, guias de produtos e aplicações de exemplo.
Os agentes podem consultar estes índices para encontrar rapidamente a documentação correta.
Gerar pedidos de API com as competências em blockchain
O Blockchain Skills proporciona conhecimentos estruturados sobre as APIs do Quicknode para agentes de programação de IA. Sem esses conhecimentos, os agentes podem gerar métodos RPC desatualizados, utilizar parâmetros incorretos ou não tirar partido das funcionalidades específicas do Quicknode.
Competências em npx adicionar quiknode-labs/competências-em-blockchain
O Skills complementa os documentos otimizados para o LLM, fornecendo padrões fiáveis de utilização da API sem alargar a janela de contexto.
Autenticar pedidos às APIs do Quicknode
As aplicações e os agentes podem autenticar os pedidos às APIs do Quicknode utilizando uma chave de API ou protocolos de pagamento «agenticos» (x402 e MPP).
Chave API (Acesso baseado na conta)
As chaves API autenticam os pedidos associados a uma conta Quicknode. Este é o modelo de acesso padrão para interagir com as APIs REST da Quicknode, com base nos planos de preços, e proporciona acesso a todas as APIs de produtos acima referidas.
Pagamentos por agente (x402 e MPP)
O Quicknode suporta dois protocolos de pagamento baseados em carteiras que proporcionam acesso à API Core (todos os pontos de ligação da blockchain, incluindo RPC, REST, gRPC e WebSocket) sem necessidade de criar uma conta. Ambos gerem a negociação de pagamentos automaticamente através dos respetivos SDKs de cliente.
- x402: Padrão aberto da Coinbase. Suporta os modelos de acesso «pagamento por pedido» e «utilização de crédito».
- MPP: Rascunho da IETF elaborado pela Tempo Labs e pela Stripe. Suporta padrões de acesso baseados em cobrança e em sessão.
Subscrições de Agentes (Acesso Total à Plataforma)
O API de subscrição de agentes cria uma conta Quicknode e ativa uma subscrição numa única solicitação de pagamento utilizando x402 ou MPP. A resposta devolve uma chave API completa da plataforma (QN_*) que proporciona acesso programático a toda a plataforma Quicknode, tal como se se registasse através do painel de controlo e adquirisse um plano. Esta opção é ideal para agentes que pretendam gerir a infraestrutura, monitorizar a utilização ou aceder a APIs não relacionadas com a blockchain, como Streams, Webhooks, Key-Value Store e Admin API.
Esta é uma alternativa à criação de uma conta através do painel de controlo. Os protocolos de pagamento x402 e MPP utilizados para o acesso RPC por pedido também permitem criar uma subscrição de conta persistente.
Gerir a infraestrutura com o Quicknode MCP
O Quicknode MCP (Model Context Protocol) permite que os assistentes de IA gerem a infraestrutura do Quicknode através da linguagem natural. O MCP funciona com base na API de administração, traduzindo instruções em linguagem natural em operações da API para criar pontos de acesso, monitorizar a utilização, configurar a segurança e gerir a faturação.
Os agentes podem realizar tarefas como:
- criação de pontos finais
- monitorização da utilização
- configurar as definições de segurança
- gestão de equipas e faturação
Adoramos ❤️ os vossos comentários!
Se tiver algum comentário ou dúvida sobre esta documentação, não hesite em contactar-nos. Adoraríamos saber a sua opinião!