Vai al contenuto principale
Base44 ti offre un ambiente flessibile e adatto agli sviluppatori per creare un’app, estenderla e mantenerla sulla piattaforma Base44. Puoi lavorare direttamente con il codice della tua app, usare strumenti per sviluppatori integrati nel prodotto, integrare con GitHub per il version control e fare affidamento sempre più su Base44 come servizio backend man mano che la piattaforma evolve.

Lavorare con il codice della tua app

Base44 ti permette di lavorare con il codice della tua app così puoi creare esperienze personalizzate pur continuando a fare affidamento sulla piattaforma per infrastruttura e runtime. Rimani vicino al modello e alle API di Base44, il che aiuta la tua app a comportarsi in modo coerente tra ambienti e semplifica l’adozione di nuove funzionalità della piattaforma nel tempo. Puoi combinare low code e full code nello stesso progetto. Parti dalle primitive di Base44, poi passa al codice quando hai bisogno di logica personalizzata, integrazioni o UI che vanno oltre quanto disponibile subito. Questo equilibrio ti dà sia velocità che controllo senza costringerti a mantenere la tua piattaforma sottostante.
Editor del codice accanto all'anteprima live dell'app, con le opzioni per salvare o annullare le modifiche

Codice e anteprima live affiancati


Modificare una funzione backend

Le funzioni backend eseguono la logica lato server della tua app. Ad esempio inviano email, elaborano pagamenti o chiamano altri servizi. Puoi modificare tu stesso il codice di una funzione in Code, ridistribuirla e testarla prima di pubblicare.
Per modificare il codice ti serve un piano a pagamento. Con il piano Free puoi vedere il codice della tua app, ma non modificarlo. Scopri di più sui piani.
Per modificare e ridistribuire una funzione backend:
  1. Clicca Dashboard in alto nell’editor dell’app.
  2. Clicca Code.
  3. In Code files, apri base44 > functions > la cartella della tua funzione, poi clicca entry.ts.
  4. Modifica il codice.
  5. Clicca Save & Redeploy.
Uno screenshot del file entry di una funzione backend aperto in Code, con il pulsante Save & Redeploy evidenziato

Salvare e ridistribuire una funzione backend

Cosa cambia con la ridistribuzione:
  • Anteprima e test: usano subito la nuova versione.
  • App live: continua a eseguire la versione dell’ultima pubblicazione finché non pubblichi di nuovo. La pubblicazione manda live insieme tutte le modifiche su main, quindi non puoi pubblicare una sola funzione.
  • Automazioni e workflow: usano subito la nuova versione, senza pubblicare.
  • Branch: puoi ridistribuire solo su main. Su un branch il pulsante è Save, e la modifica arriva su main quando fai il merge. Scopri di più sulle funzioni backend su un branch.
Per testare una funzione backend:
  1. Clicca Dashboard in alto nell’editor dell’app, poi clicca Code.
  2. Apri il file entry.ts della tua funzione e salva o annulla eventuali modifiche.
  3. Clicca Test Function in basso a destra.
  4. In Payload, inserisci l’input JSON che la funzione si aspetta.
  5. Clicca Run Function.
Uno screenshot del pannello Test Function con il campo Payload, con il pulsante Run Function evidenziato

Testare una funzione backend

Scopri di più su come scrivere funzioni backend e come modificare il codice della tua app nella documentazione per sviluppatori.

Usare gli strumenti per sviluppatori integrati

Base44 include strumenti per sviluppatori che ti aiutano a capire come si comporta la tua app in tempo reale e a fare il debug dei problemi in modo più efficiente. Invece di aggiungere logging ad hoc o costruire dashboard separate, puoi ispezionare cosa sta succedendo direttamente dall’ambiente Base44. Questi strumenti ti permettono di vedere come la tua app comunica con i servizi Base44 e le integrazioni esterne, monitorare richieste e risposte e mostrare eventi, errori o avvisi importanti. Puoi convalidare le ipotesi mentre lavori, poi iterare in sicurezza in ambienti di staging o anteprima prima di distribuire le modifiche in modo più ampio.
Scopri di più sul monitor delle attività

Integrare con GitHub

Base44 supporta un workflow basato su GitHub così puoi gestire il codice della tua app con pratiche moderne di version control. Collegare la tua app a GitHub semplifica la collaborazione con il tuo team e il mantenimento di una cronologia pulita di ogni modifica che entra nella tua app. Puoi usare branch e pull request per revisionare il lavoro prima che vada live, imporre requisiti di review o di check e mantenere stabili i branch principali. Quando colleghi workflow e check di GitHub, puoi testare e convalidare ogni modifica, poi lasciare che Base44 gestisca la distribuzione dal codice revisionato. Questo crea un percorso chiaro e verificabile dal commit alla produzione.
Pannello di connessione a GitHub con l'opzione per collegare un'app

Collegarsi a GitHub


Esportare il codice

Puoi scaricare il codice della tua app come file ZIP per conservarne una copia, rivederlo o lavorarci con i tuoi strumenti. Il codice esportato dipende comunque da Base44 per funzionare. Quindi uno ZIP è una copia del codice, non un modo per spostare la tua app fuori da Base44.
Cosa ti serve per esportare:
  • Un piano a pagamento: l’esportazione ZIP è disponibile dal piano Builder in su. Scopri di più sui piani.
  • Accesso in modifica: se puoi solo visualizzare un’app, non puoi esportarla.
  • Un computer: l’opzione non è disponibile quando usi l’editor dell’app da telefono.

Scaricare lo ZIP

Scarica dall’editor dell’app una copia del codice salvato attuale della tua app.
Cosa contiene lo ZIP:
  • Un progetto React standard creato con Vite, configurato come il codice che vedi in Code e in un repository GitHub collegato.
  • Il codice frontend, le funzioni backend e la struttura dei dati (i campi e i permessi di ogni tabella).
  • I dati della tua app non sono inclusi. Esporta invece ogni tabella come file CSV. Scopri come esportare i dati della tua app.
  • I segreti e gli utenti dell’app non sono inclusi. Restano in Base44.
  • La cronologia delle versioni non è inclusa. Lo ZIP contiene il codice salvato attuale della tua app.
Per esportare il codice della tua app:
  1. Vai all’editor dell’app.
  2. Clicca sull’icona More actions in alto a destra.
  3. Seleziona Export project as ZIP.
    Uno screenshot del menu More actions nell'editor dell'app con Export project as ZIP evidenziato

    Esportare il progetto dal menu More actions

  4. Clicca su Download ZIP.
    Uno screenshot della finestra Export to ZIP nell'editor dell'app con il pulsante Download ZIP evidenziato

    Scaricare il codice della tua app come file ZIP

Eseguirlo altrove

Il codice esportato è pensato per funzionare con Base44. Usa l’SDK di Base44 per collegarsi al backend della tua app su Base44 per dati, accessi, funzioni backend e integrazioni. Se esegui il codice altrove, queste funzionalità arrivano comunque da Base44 e usano i dati della tua app live. Base44 non supporta il self-hosting. Non puoi eseguire il backend di Base44 sui tuoi server, inclusi il database, il sistema di accesso e le integrazioni. Per eseguire la tua app completamente fuori da Base44, dovresti sostituire queste parti con un tuo backend e modificare il codice che le usa. Ecco invece cosa puoi fare con il tuo codice:
Collega la tua app a GitHub per mantenere il codice sincronizzato in entrambe le direzioni. Poi puoi modificarlo nel tuo editor, eseguirlo sul tuo computer con la CLI di Base44 e vedere le modifiche nell’editor dell’app. Scopri come collegarti a GitHub e configurare lo sviluppo locale.
Esporta il codice come ZIP, poi esporta ogni tabella di dati come file CSV da Data nella dashboard dell’app. Insieme ti danno una copia del codice della tua app e dei suoi record.

Collegarti ad API esterne

Base44 include un livello di integrazioni che permette alla tua app di chiamare servizi esterni senza che tu debba gestire ogni chiamata API a mano. Invece di collegare ogni provider da solo, usi le integrazioni di Base44 per gestire pattern comuni come parlare con modelli IA, lavorare con file, inviare email o chiamare API personalizzate, mentre Base44 gestisce credenziali ed esecuzione sul backend. Ci sono 2 tipi principali di integrazioni:
  • Le integrazioni integrate coprono compiti comuni come generare testo o immagini con l’IA, caricare e servire file o estrarre dati strutturati da documenti.
  • Le integrazioni personalizzate permettono a un amministratore del workspace di importare una specifica OpenAPI per quasi qualsiasi API esterna ed esporla alle tue app come integrazione riutilizzabile e nominata, proxata attraverso il backend Base44.
Le chiamate alle integrazioni vengono sempre eseguite sull’infrastruttura Base44, quindi segreti e token non risiedono mai nel tuo frontend. Puoi invocarle nel contesto della persona che sta usando la tua app oppure con un service role che ha permessi elevati per workflow di amministrazione e automazione. Questo ti offre un modo flessibile per collegare Base44 al resto del tuo stack mantenendo sicurezza e controllo degli accessi in un unico posto.

Usare Base44 come servizio backend (BaaS)

Base44 include una piattaforma backend gestita pensata per agenti IA e app full stack moderne. Gestisce le esigenze fondamentali del backend come archiviazione dati, autenticazione, aggiornamenti in tempo reale, funzioni serverless, integrazioni e hosting così puoi concentrarti sulla logica di prodotto e sull’esperienza.
Scheda terminale che esegue base44 deploy, con l'URL dell'app distribuita e Auth, Realtime, Storage, CRON e AI

Base44 come backend

Puoi eseguire Base44 come servizio solo backend quando porti il tuo frontend o colleghi applicazioni esistenti, oppure usarlo come backend per progetti full stack generati da template Base44. La CLI impalca progetti con la configurazione di cui hai bisogno e li collega al tuo backend Base44, mentre la dashboard ti permette di gestire dati, auth, funzioni e integrazioni. Qualsiasi framework frontend può comunicare con Base44 tramite l’SDK JavaScript. Durante lo sviluppo locale, il tuo frontend gira sul proprio dev server e si connette al backend Base44 hostato per dati e funzioni. Quando sei pronto ad andare live, puoi continuare a hostare il tuo frontend altrove oppure distribuire gli asset compilati all’hosting Base44 con domini personalizzati e HTTPS automatico. Base44 fornisce un livello dati NoSQL flessibile, autenticazione e controllo degli accessi integrati e subscription in tempo reale così la tua app può reagire ai cambiamenti mentre avvengono. Puoi aggiungere logica backend personalizzata con funzioni basate su TypeScript e collegare servizi esterni tramite connettori e integrazioni, ad esempio per modelli IA, email o gestione dei file.

Risolvere i problemi delle funzioni backend

La maggior parte degli errori delle funzioni backend dipende dalla richiesta, dal codice della funzione o dal modo in cui le funzioni si chiamano tra loro. Quando la tua funzione viene eseguita, Base44 trasmette il codice di stato e la risposta restituiti dal suo codice. Quindi la maggior parte degli errori che vedi viene dalla funzione stessa. Gli errori di salvataggio e ridistribuzione di una funzione sono diversi. Compaiono come Deployment Error in Code e non significano che la funzione abbia fallito durante l’esecuzione. Se una funzione backend non funziona, trova la tua situazione qui sotto.
Le funzioni backend accettano richieste sia GET sia POST, quindi il metodo della richiesta non causa un 404. Aprire l’URL di una funzione nel browser invia una richiesta GET senza body. Se la funzione si aspetta dei dati, restituisce un errore anche se funziona.Inizia testando la funzione da Code. Se il test riesce, la funzione funziona e il problema è nella richiesta. Invia i dati che la funzione si aspetta: nella query string per una richiesta GET o nel body per una richiesta POST.Se anche il test restituisce un 404, o nessuna delle tue integrazioni raggiunge le funzioni:
  1. Controlla che il tuo piano includa le funzioni backend. Scopri di più sui piani.
  2. Controlla che l’URL o la chiamata usi il nome esatto della funzione, cioè il nome della sua cartella sotto base44 > functions in Code.
  3. Apri il file entry.ts della funzione e clicca su Save & Redeploy per distribuirla di nuovo.
  4. Testa di nuovo la funzione.
Questi errori dipendono quasi sempre dal codice della tua funzione o da un servizio che chiama, non da Base44:
  • 400 (richiesta non valida): la richiesta è stata rifiutata, ad esempio perché un campo manca o non è valido. Base44 restituisce un 400 solo se chiami un’integrazione integrata per nome come se fosse una funzione backend. In quel caso il messaggio di errore indica l’integrazione da usare.
  • 409 (conflitto): la richiesta è entrata in conflitto con qualcosa, ad esempio un record che esiste già. Base44 non restituisce mai un 409 quando esegue una funzione.
Ogni funzione decide cosa significano i propri errori, quindi i suoi log e il suo codice ne mostrano la causa.Per trovare la causa:
  1. Clicca su Dashboard nell’editor della tua app.
  2. Clicca su Code.
  3. Sotto Code files, apri base44 > functions > la cartella della tua funzione, poi clicca su entry.ts.
  4. Clicca su Logs, poi trova l’errore della chiamata non riuscita.
  5. Cerca nel codice della funzione lo stato restituito e controlla cosa nella richiesta porta lì, ad esempio un campo mancante o non valido.
  6. (Facoltativo) Chiedi alla chat AI di trovare la causa:
Questo errore significa che la funzione non è riuscita ad avviarsi quando Base44 l’ha distribuita. A volte è un problema temporaneo, quindi prova prima di nuovo Save & Redeploy. Se continua a non funzionare, qualcosa nel codice della funzione ne impedisce l’esecuzione.Per correggere l’errore:
  1. Chiedi alla chat AI di correggere la funzione:
  2. Se hai modificato tu il codice, confrontalo con il formato usato dall’AI. Le funzioni nell’editor dell’app racchiudono la loro logica in Deno.serve(). Ogni import inizia con npm:, jsr: o node:, oppure è un percorso relativo come ./helpers.ts.
  3. Clicca su Save & Redeploy, poi pubblica la tua app così l’app live riceve la funzione corretta.
Un errore quando clicchi su Save & Redeploy dipende dal deployment della funzione, non dalla sua esecuzione. La tua app esegue un deployment alla volta. Quindi il salvataggio fallisce se è ancora in corso un altro deployment per l’app, ad esempio mentre la chat AI sta ancora applicando una modifica o la tua app è in pubblicazione. Attendi un momento, poi clicca di nuovo su Save & Redeploy. Lo stesso conflitto restituisce un errore 409 quando esegui il deployment con la CLI o l’API, e puoi riprovare in sicurezza.Se invece l’errore elenca problemi nel tuo codice, la build della funzione non è riuscita. Correggi le righe indicate, o chiedi alla chat AI di correggerle, poi salva di nuovo.
Una chiamata di una funzione backend a Base44 fallisce con un errore 403 e il messaggio “The domain’s DNS records point to a prohibited IP address.” La risposta può anche essere solo error code: 1000. Qualsiasi chiamata può fallire così, inclusi lettura o scrittura di record, integrazioni e chiamate ad altre funzioni. Riprovare non aiuta, ma riavviare lo stesso processo dall’inizio funziona.Succede quando la funzione si trova troppo in profondità in una catena di funzioni backend che si chiamano tra loro. Ogni chiamata da una funzione a un’altra aggiunge un livello alla catena, sia con base44.functions.invoke() sia con un fetch() all’URL di una funzione. Una catena può contenere fino a 7 funzioni, inclusa quella che la avvia. L’8ª funzione di una catena, e tutte le successive, non possono raggiungere Base44.Per correggere l’errore:
  1. Trova la catena. Cerca una funzione che invoca se stessa, o funzioni che si invocano una dopo l’altra. Ad esempio, una funzione che elabora un passaggio di un lavoro lungo e poi invoca se stessa per il passaggio successivo.
  2. Avvia ogni passaggio da una nuova richiesta invece che dal passaggio precedente. Fai elaborare alla funzione un passaggio, salvare i progressi su un record e terminare. Poi avvia il passaggio successivo dal frontend della tua app, o da un workflow programmato che riprende il lavoro non finito.
  3. Se una funzione chiama un’altra funzione solo per riusarne il codice, sposta quel codice in un file in base44/shared/ e importalo in entrambe le funzioni. Consulta Condividere codice tra funzioni.
  4. Se non sai dove si trova la catena, chiedi alla chat AI di trovarla:
Alcuni servizi, come Telegram e WhatsApp, inviano le richieste webhook dai propri server e non possono includere dati di accesso come una chiave API o header personalizzati. Se la funzione che riceve il webhook richiede l’autenticazione, questi servizi ricevono un errore 403.Modifica la funzione ricevente in modo che non controlli un utente che ha effettuato l’accesso o una chiave API. Per mantenere l’autenticazione sulle altre funzioni, crea una funzione pubblica separata solo per questi servizi. Usala solo per azioni non sensibili.
Se una funzione continua a non funzionare, contatta il Customer Care. Includi il link dell’app, i nomi delle funzioni interessate e quando è iniziato il problema, ad esempio dopo una pubblicazione o una modifica al codice.

FAQ

Clicca su una domanda qui sotto per saperne di più.
L’activity monitor mostra le azioni e le richieste più recenti della tua app. Puoi usarlo per vedere l’attività degli utenti, monitorare le prestazioni e risolvere i problemi in tempo reale.Per aprirlo, clicca sull’icona More actions nella barra superiore e seleziona Activity monitor:
Il pannello Activity monitor sopra l'editor dell'app, con le richieste recenti e i relativi metodo, percorso, ora e stato

L'activity monitor elenca le richieste della tua app

Puoi vedere i file e i componenti della tua app dalla barra superiore e dalla vista del codice.
  • Clicca sull’icona More actions nella barra superiore e seleziona This page’s files per vedere i file usati nella pagina che stai modificando. Usa See all files per aprire l’elenco completo dei file.
  • Clicca su Dashboard, poi su Code per aprire la struttura completa dei file della tua app e sfogliare i componenti.
  • Per scaricare tutto come file ZIP, consulta Esportare il codice.
  • Per collegare il progetto a GitHub per un version control avanzato, clicca sull’icona More actions , seleziona GitHub connection e segui i passaggi di configurazione.
Il collegamento a GitHub richiede un piano Builder o superiore.
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.