Vai al contenuto

Sviluppatori

Sviluppa su Route Royal

L’SDK, l’API, i webhook, le app OAuth e il server MCP, per i tuoi siti, app e agenti. Gli strumenti per sviluppatori sono nel portale, aperto alle organizzazioni a cui abbiamo dato l’accesso.

  1. Uno sviluppatore con accesso

  2. Accesso effettuatoIl tuo account Route Royal
  3. La tua organizzazioneL’accesso è suo
  4. Il tuo ruoloPuò gestire l’area sviluppatori?
  5. Accesso sviluppatoreConcesso alla tua organizzazione
  6. Portale sviluppatoriAutorizzato

Tutti i controlli superati: chiavi, app e webhook sono tuoi da gestire.

Con cosa sviluppi

Cinque modi per entrare

Ognuno lavora con i dati della tua organizzazione e i permessi che concedi.

  • SDK Next.js

    Hook tipizzati per il browser e client per il server: autenticazione, annunci, prenotazioni, richieste, articoli, e-commerce e analytics per siti headless. Questo sito è fatto con l’SDK.

  • API REST

    Leggi e scrivi i dati della tua organizzazione su api.routeroyal.com, con chiavi limitate a ciò che serve a ogni integrazione.

  • Webhook

    Eventi per contatti, trattative, immobili, prodotti, ordini, pagamenti e molto altro, firmati con HMAC-SHA256 per verificare che arrivino da noi.

  • App OAuth

    Fai accedere le persone con Route Royal e agisci per loro tramite OAuth 2.0: codici di autorizzazione, token e revoca.

  • Server MCP

    Dai ai tuoi agenti gli strumenti di Route Royal tramite il Model Context Protocol, nei limiti dei permessi che concedi.

Come ottenere l’accesso

Dalla richiesta alle chiavi live

  1. 1

    Chiedi l’accesso

    Raccontaci cosa stai sviluppando e per quale organizzazione.

  2. 2

    Lo attiviamo noi

    Attiviamo l’accesso sviluppatore per la tua organizzazione, alle condizioni che concordiamo con te.

  3. 3

    Crea le tue chiavi

    Accedi, registra il tuo dominio, verificalo via DNS e crea una chiave pubblicabile e una segreta.

  4. 4

    Vai online

    Sviluppa con chiavi di test, poi passa a quelle live al lancio.

Chiavi

Due chiavi, tenute separate

Ogni chiave SDK appartiene a un dominio che hai verificato. La chiave completa viene mostrata una sola volta e noi ne conserviamo solo l’hash.

  • Le chiavi pubblicabili (pk_) possono solo leggere, quindi sono sicure nel browser.
  • Le chiavi segrete (sk_) possono scrivere, quindi restano sul tuo server.
  • Ogni chiave è legata a un dominio verificato e può avere una data di scadenza e un elenco di IP consentiti.
  • Le richieste hanno un limite di frequenza, così nessuna integrazione toglie risorse alle altre.
.env.local
NEXT_PUBLIC_ROUTEROYAL_DOMAIN=www.example.com
NEXT_PUBLIC_ROUTEROYAL_PUBLIC_KEY=pk_test_…

# Solo server: mai nel codice del browser
ROUTEROYAL_SECRET_KEY=sk_test_…

Domande

Cosa chiedono gli sviluppatori

Chi può ottenere l’accesso sviluppatore?

Le organizzazioni su Route Royal. Lo concediamo per organizzazione e, al suo interno, possono usarlo le persone il cui ruolo consente di gestire le impostazioni sviluppatore.

L’accesso sviluppatore ha un costo aggiuntivo?

Concordiamo le condizioni con ogni organizzazione quando concediamo l’accesso. Chiedici e ti diremo cosa vale per quello che stai sviluppando.

Dov’è la documentazione?

Arriva con l’accesso. L’SDK è un pacchetto privato con la sua guida inclusa, e seguiamo ogni nuova integrazione insieme al team che la sviluppa.

Mi serve l’accesso sviluppatore per usare Claude o ChatGPT con Route Royal?

No. Collegare Claude o ChatGPT alla tua organizzazione fa parte di IA e Q. L’accesso sviluppatore serve a creare i tuoi siti, app e agenti.

Ci sono limiti di frequenza?

Sì. Ogni chiave e ogni token ha un limite di frequenza, e gli agenti IA hanno limiti propri al minuto e per sessione. Ti indichiamo i limiti che si applicano quando concediamo l’accesso.

C’è già qualcosa costruito su Route Royal?

Questo sito web. Le sue news sono articoli di Route Royal letti tramite l’SDK, nello stesso modo in cui il tuo sito leggerebbe i tuoi annunci, prenotazioni o articoli.

Accesso sviluppatore

Fai la tua prima chiamata a Route Royal

L’accesso sviluppatore si concede per organizzazione. Raccontaci cosa stai costruendo e per quale organizzazione. Una volta attivato, crei le tue chiavi nel portale e fai questa chiamata con le tue.

Le richieste si inviano per email a support@routeroyal.com.

lib/news.ts
Output

Due articoli, letti sul tuo server con una chiave pubblicabile: è così che questo sito legge le sue notizie.

Chiavi e dati di esempio