La registrazione della tua app OAuth 2.0 consente di accedere alle risorse Roblox. Dopo la registrazione, Roblox assegna all'app un ID client unico e segreto che puoi utilizzare per ottenere l'autorizzazione dagli utenti per accedere alle loro informazioni e risorse Roblox.
Registrazione della tua app
Per registrare un'applicazione:
- Nella Dashboard del Creatore, vai alla pagina App OAuth 2.0.
- Click the Crea App OAuth 2.0 button.
- Inserisci un Nome Applicazione valido e unico a livello globale.
- Leggi e accetti i Termini di servizio Roblox e fai clic su Crea .
- Copia e memorizza il Client ID e il Secret in un Postosicuro. Dopo aver chiuso la pagina, non hai più accesso al segreto e puoi generarne uno nuovo. Dopo aver registrato un'applicazione, puoi ancora accedere e modificare le altre proprietà dell'applicazione.
- Fai clic su Continua modifica per configurare la tua applicazione, che è descritta nelle seguenti sezioni.
Configurazione della generale informazioni
Una volta che hai registrato la tua applicazione, dovresti configurare le sue informazioni generali, tra cui:
- Una Descrizione, che è visibile a tutti nella comunità Roblox.
- Un'immagine in miniatura per la tua applicazione. La dimensione del file raccomandata è almeno 150x150 pixel.
- Un Link di Entrata come punto di ingresso della tua applicazione, come la homepage del sito web dell'applicazione.
- A Privacy Termini URL e a Termini di Servizio URL per gli utenti finali da leggere prima di autorizzare la tua applicazione. Ogni URL deve essere HTTPS e non più di 256 caratteri.
Aggiungere autorizzazioni
Per garantire un controllo e una sicurezza appropriati all'interno della tua applicazione, devi aggiungere Permission Scopes . Ci sono due tipi di scala di autorizzazione disponibili:
- ID delle identità per l'autenticazione, come openid per gli ID degli utenti e profile per i profili completi. Se selezioni lo script del 0> Profilo0>, devi anche selezionare 3> openid 3>.
- API-specific permission scopes , come asset:read per la autorizzazione di lettura delle risorse. Seleziona solo il numero minimo di scopi di cui hai bisogno per la tua applicazione.
Aggiungere URL di reindirizzamento
Riindirizzare URL sono i punti di destinazione della tua app a cui gli utenti vengono reindirizzati quando finiscono l'autorizzazione della tua applicazione. Assicurati che i tuoi URL di destinazione soddisfino i seguenti requisiti:
- Tutti gli URL delle reindirizzazioni devono essere in una delle seguenti forme:
- Plain HTTPS, per esempio: https://www.example.com .
- Percorsi su localhost con HTTP o HTTPS (certificato firmato da noi) per scopi di debug locali, ad esempio:
- http://localhost:80
- https://localhost:80
- Schemi personalizzati per applicazioni o scopi specifici, ad esempio:
- my-app-scheme:/
- my-app-scheme://foo/bar/...
- my-app://action?param1=value1¶m2=value2
- La lunghezza massima di una URL di reindirizzazione è 256 caratteri.
- Puoi aggiungere fino a 10 URL di reindirizzamento. Con più URL di reindirizzamento, puoi avere ambienti di test e consentire agli utenti di migrare tra due siti senza interruzione.
Invio per la revisione
Per ridurre al minimo le possibilità che app dannose danneggino la comunità, la registrazione di un'app non la rende pubblicamente accessibile. Invece, rimane in modalità privata con un limite di 100 utenti autorizzati. Questa modalità è utile per testare e debugger in team.
Se vuoi estendere la base utente per la tua applicazione, devi pubblicarla in modalità pubblica inviandola per la Revisionare:
- Vai alla pagina App OAuth 2.0.
- Fai clic sul pulsante Modifica e Pubblica per l'app che vuoi Pubblicare.
- Compila tutte le informazioni richieste e fai clic sul pulsante Revisiona e Pubblica . Una messaggio con limiti sulle autorizzazioni del tuo app durante la sessione di review in sospeso appare.
- Click Invia per la revisione .
Mentre la tua app è in attesa di recensione, non puoi modificare o inviare un'altra richiesta fino a quando la richiesta di recensione attuale non è approvata o rifiutata. La tua app rimane in modalità privata durante la Revisionare. Quando la tua app viene approvata, passa alla modalità pubblica e non puoi tornare alla modalità privata.
Indipendentemente dal fatto che la tua app sia approvata o rifiutata, ricevi una notifica di e-mail del risultato quando la revisione è completata.
Modifica e Cancellazione della tua app
Puoi modificare o eliminare la tua app con i seguenti passaggi se non è in Revisionare:
Vai alla pagina App OAuth 2.0.
Click Modifica or Cancellare for the desired applicazione.
- Se hai scelto di modificare un'applicazione, segui gli stessi passaggi e requisiti di registrazione .
- Se scegli di eliminare un'applicazione, fai clic su Sì, Elimina per confermare la cancellazione. Dopo aver eliminato un'applicazione, non puoi recuperarla.
La modifica delle informazioni generali della tua applicazioneo dei URL dirottamento non richiede che gli utenti autorizzino nuovamente l'applicazione. Tuttavia, se aggiungi o modifichi gli scopi di autorizzazione, devi ottenere l'autorizzazione per i nuovi permessi dai tuoi utenti e acquisire un nuovo set di token. Se non ottieni l'autorizzazione per i nuovi scopi, la tua app può continuare ad utilizzare gli script esistenti, ma è limitata agli script precedenti.
Per gli app in modalità privata, il sistema aggiorna automaticamente le tue modifiche con i tuoi utenti. Per gli app in modalità pubblica, devi inviare l'app per la review senza rilasciarla alla community al fine di riflettere queste modifiche. Altrimenti, il sistema salva le modifiche non pubblicate per te senza rilasciarle alla community.