acesso proxy

O site oficial Raydo expõe um Web Surface pequeno, mas estável, ao proxy IA. Não é uma plataforma API de automação pública completa, mas fornece acesso a documentação detectável, downloads de desktop e autorização de dispositivos.

O que um agente pode encontrar aqui?

• Documentação do produto e uso: /docs
• Entrada de download da versão desktop: /download, abrangendo macOS, Windows, Linux
• Portal de contato: /contact, para suporte, cooperação e comunicação corporativa
• Autorização do dispositivo relacionada a API: /api/cloud/device-auth/*
• Session e API Interface de verificação de chave: /api/auth/* e /api/cloud/verify-key
• Notion Desktop Relay OAuth Entrada: /api/oauth/notion/*

Descubra a entrada

API Catalog

• /.well-known/api-catalog
• Tipo de conteúdo: application/linkset+json
• Objetivo: listar as páginas API e a documentação atualmente pública no site oficial e adequada para descoberta de máquina

OAuth Metadados do serviço de autorização

• /.well-known/oauth-authorization-server
• /.well-known/openid-configuration
• Objetivo: Descrição Raydo Desktop Navegador usado atualmente Session Login e processo de autorização do dispositivo

OAuth Metadados de recursos protegidos

• /.well-known/oauth-protected-resource
• Objetivo: descrever qual API protegido requer credenciais Bearer e escopos relacionados

MCP / WebMCP Entrada de descoberta

• /.well-known/mcp/server-card.json
• Quando o navegador suporta navigator.modelContext.provideContext(), a página do site oficial irá expor a ferramenta WebMCP no nível do site ao carregar
• Objetivo: permitir que os agentes descubram documentos, downloads e entrem em contato com esses recursos de navegação do site

Negociação de redução

• Envie Accept: text/markdown para páginas de marketing e páginas de documentação oficiais suportadas
• Tipo de conteúdo de retorno: text/markdown; charset=utf-8
• O cabeçalho de resposta conterá Vary: Accept, Content-Signal, x-markdown-tokens
• Se Raydo for implantado atrás de uma zona com Cloudflare Markdown for Agents habilitado, esta camada de sidewalling do aplicativo poderá ser substituída ou aprimorada com transformações nativas da plataforma

Índice de habilidades do agente

• /.well-known/agent-skills/index.json
• Objetivo: Expor as habilidades do agente e o índice de entrada atualmente fornecido pelo site oficial

O modo de autenticação autêntica atual do site oficial

Raydo Existem atualmente dois tipos principais de métodos de autenticação que o site oficial pode realmente explicar ao mundo exterior:

1. Autenticação do navegador Session

/api/auth/[...all] é fornecido por better-auth e realiza os processos de login e Session do próprio site oficial.

2. Raydo Desktop Processo de autorização do dispositivo

Raydo Desktop usa o processo de autorização do dispositivo:

1. POST /api/cloud/device-auth/create Crie o código do dispositivo e o endereço de verificação
2. O usuário autoriza o dispositivo através de POST /api/cloud/device-auth/authorize após fazer login pelo navegador
3. A área de trabalho pesquisa o status por meio de POST /api/cloud/device-auth/poll
4. O desktop usa POST /api/cloud/device-auth/exchange em troca de resultados de troca únicos
5. A verificação subsequente pode passar pela chave POST /api/cloud/verify-key Bearer API

Isso permite que o caminho de acesso ao desktop seja descoberto, mas não afirma falsamente que o site oficial já é uma plataforma OAuth universal completa.

Escopo e limites atuais

• Raydo site oficial não público em geral MCP back-end de automação
• O site oficial do Raydo não divulgou a descrição pública completa do OpenAPI
• API parcialmente protegido atende principalmente Raydo Desktop com um cliente de terceiros, e não com qualquer automação de terceiros
• Esses metadados de descoberta devem ser entendidos como dicas de capacidade, não como autorizações padrão

Agentes recomendados por onde começar

• Leia /docs primeiro para entender o produto e os limites de acesso
• Oriente os usuários para /download quando a instalação for necessária
• Use interfaces relacionadas à autenticação do dispositivo somente ao inicializar Raydo Desktop para fazer login
• Use /contact quando for necessário suporte humano, colaboração ou comunicação corporativa