Polylane per sviluppatori
Tutto quello che ti serve per costruire su Polylane: l'API, il server MCP, la CLI, l'SDK e come autenticarti. Agenti: questa pagina è disponibile anche in markdown su /developers.md.
Quickstart di Polylane
- Ottieni l'accesso: Polylane è in fase di pre-lancio; iscriviti alla lista d'attesa dalla homepage (oppure
POST https://polylane.com/api/auth/email). - Accedi: una volta invitato, accedi su console.polylane.com e collega un account cloud o un repository.
- Genera una chiave API: crea una chiave (
sk_...) nelle impostazioni della console. - Prima richiesta:
curl https://api.polylane.com/v1/auth/whoami -H "x-api-key: sk_..." - Collega un agente: punta qualsiasi client MCP su
https://mcp.polylane.com/mcp. I client OAuth si registrano da soli suhttps://mcp.polylane.com/register.
API Polylane
- URL di base:
https://api.polylane.com/v1 - Specifica OpenAPI 3.0: https://api.polylane.com/v1/doc (replicata su /openapi.json)
- API catalog (RFC 9727): /.well-known/api-catalog
- Guida all'autenticazione per gli agenti: /auth.md
Server MCP di Polylane
- Prodotto (OAuth 2.0 o chiave API):
https://mcp.polylane.com/mcp, con gli strumentisearch,execute,searchTools,runTool,runCode,startMapping,advanceMapping,getMappingStatus. Server card. - Documentazione (senza autenticazione):
https://docs.polylane.com/mcp, per elencare e leggere ogni pagina della documentazione.
CLI Polylane
Costruita per essere guidata dagli agenti di coding: output strutturato e flag non interattivi ovunque.
curl -fsSL https://polylane.com/setup.sh | bash # macOS / Linux
irm https://polylane.com/setup.ps1 | iex # Windows
polylane auth signup --email you@example.com Documentazione completa della CLI: docs.polylane.com/coding-agents/cli.
SDK
- npm: @coreplane/polylane
Limiti di frequenza
Le richieste sono limitate per credenziale. Quando superi un limite l'API risponde
429: rallenta e rispetta Retry-After
quando presente, con backoff esponenziale invece di riprovare in un ciclo stretto.
Versioni e deprecazioni
L'API è versionata nel percorso dell'URL (/v1). Le modifiche incompatibili escono solo in una nuova versione. Le deprecazioni vengono annunciate nel build log
e documentate prima della rimozione; le superfici deprecate continuano a funzionare durante il periodo di transizione.
Punti di ingresso leggibili dalle macchine
- /llms.txt: indice del sito per gli agenti
- /agent.json: vista strutturata del prodotto (anche su
/?mode=agent) - /.well-known/mcp: discovery MCP
- /.well-known/agent-card.json: agent card A2A
- /.well-known/agent-skills/index.json: indice delle skill
Stato
Disponibilità in tempo reale della piattaforma Polylane: status.polylane.com.
Supporto
Scrivi a boris@coreplane.ai oppure trovaci su X, @polylanehq.