Accès des agents

Raydo expose une petite surface Web publique pour les agents IA. Ce site n'est pas un API d'automatisation publique complète, mais il fournit des points de terminaison de découverte stables pour la documentation, l'intégration des postes de travail et les flux d'appareils authentifiés.

Ce que les agents peuvent découvrir ici

• Documentation sur /docs pour des conseils sur le produit, la configuration et l'intégration
• Desktop flux de téléchargement à /download pour les installateurs macOS, Windows et Linux - Contactez les points d'entrée à /contact pour obtenir de l'aide, des partenariats et des conversations d'entreprise.
• Autorisation de l'appareil APIs sous /api/cloud/device-auth/* pour Raydo Desktop connexion et échange de clés
• Vérification des clés Session et API sous /api/auth/* et /api/cloud/verify-key
• Points de terminaison Notion Desktop Broker sous /api/oauth/notion/* pour le transfert de connexion Raydo Desktop

Points de terminaison de découverte

API catalogue

• /.well-known/api-catalog
• Type de contenu : application/linkset+json
• Objectif : répertorie les surfaces API publiques et les liens de documentation que les agents peuvent inspecter avant l'intégration.

OAuth métadonnées du serveur d'autorisation

• /.well-known/oauth-authorization-server
• /.well-known/openid-configuration
• Objectif : décrit le flux de connexion à la session de navigateur et d'autorisation de l'appareil utilisé par Raydo Desktop

OAuth métadonnées de ressources protégées

• /.well-known/oauth-protected-resource
• Objectif : explique quels Raydo API protégés nécessitent des informations d'identification du porteur et quelles étendues ils utilisent

Découverte de MCP et WebMCP

• /.well-known/mcp/server-card.json
• Les pages du navigateur exposent les outils WebMCP au chargement lorsque navigator.modelContext.provideContext() est disponible
• Objectif : permet aux agents de découvrir des outils de navigation au niveau du site pour les documents, les téléchargements et les flux de contacts.

Négociation de démarque

• Envoyez Accept: text/markdown aux pages marketing et de documentation prises en charge
• Type de contenu de la réponse : text/markdown; charset=utf-8
• Les en-têtes de réponse incluent Vary: Accept, Content-Signal et x-markdown-tokens
• Si Raydo est déployé derrière Cloudflare Markdown for Agents, le transformateur natif de la plateforme peut remplacer ou étendre cette solution de secours au niveau de l'application.

Indice de compétences des agents

• /.well-known/agent-skills/index.json
• Objectif : expose un index lisible par machine des compétences et des points d'entrée des agents publics documentés sur ce site.

De vrais flux d'authentification sur ce site

Raydo expose actuellement deux modèles réels liés à l'authentification que les agents peuvent rencontrer :

1. Authentification de la session du navigateur

/api/auth/[...all] est alimenté par better-auth et sert les flux de session du navigateur du site. Il s'agit de la surface de connexion utilisée par l'application Web elle-même.

2. Autorisation de l'appareil pour Raydo Desktop

Raydo Desktop utilise un flux d'autorisation de type appareil :

1. POST /api/cloud/device-auth/create crée un code d'appareil et une URL de vérification
2. L'utilisateur connecté approuve l'appareil via POST /api/cloud/device-auth/authorize
3. Desktop sonde POST /api/cloud/device-auth/poll
4. Desktop échange le code à usage unique à POST /api/cloud/device-auth/exchange
5. Une clé API au porteur peut être vérifiée ultérieurement avec POST /api/cloud/verify-key

Cela rend l'intégration du bureau et le flux du pont cloud détectables sans revendiquer une plate-forme publique générique OAuth qui n'existe pas.

Portée et limites actuelles

• Raydo n'expose pas un backend d'automatisation MCP public à usage général à partir de ce site marketing
• Raydo ne publie pas encore de description publique complète de OpenAPI
• Certains API protégés sont destinés à Raydo Desktop et aux clients propriétaires de confiance, et non à une automatisation tierce arbitraire.
• Les métadonnées de découverte doivent être traitées comme des indices de capacité, et non comme une autorisation générale.

Points d'entrée recommandés pour les agents

• Commencez par /docs pour comprendre le produit
• Envoyez les utilisateurs à /download lorsque l'installation est nécessaire
• Utilisez les points de terminaison d'authentification de l'appareil uniquement pour guider l'intégration de Raydo Desktop
• Utilisez /contact pour les questions de suivi humain, d'assistance ou d'accès à l'entreprise