Passer au contenu principal
Suivez ce quickstart pour ajouter Base44 à votre projet Hono. Vous allez créer un backend Base44, définir des entités et intégrer le SDK dans vos routes API.
La CLI nécessite Node.js 20.19.0 ou supérieur.

Configuration

1

Installer la CLI Base44

Installez la CLI Base44 globalement :
npm install -g base44@latest
2

Créer un backend Base44

Naviguez vers le répertoire de votre projet Hono, puis exécutez :
base44 create
Si vous n’êtes pas déjà connecté, la commande vous demandera de vous authentifier.Sélectionnez Create a basic project lorsque demandé. Cela crée les fichiers backend dans le répertoire de votre projet Hono. Suivez ensuite les invites pour configurer votre projet.Lorsque vous créez un projet, les skills Base44 sont incluses automatiquement, fournissant à votre agent IA des instructions et du contexte pour les tâches Base44.
3

Configurer le répertoire de sortie (facultatif)

Si vous servez des fichiers statiques avec Hono, mettez à jour config.jsonc pour pointer vers votre sortie de build. Ajoutez ou modifiez le champ site.outputDirectory :
{
  "site": {
    "outputDirectory": "dist"
  }
}
Si vous construisez une API pure avec Hono et ne servez pas de frontend, vous pouvez ignorer la configuration outputDirectory ou omettre cette étape.
4

Définir des entités

Créez des schémas d’entités pour définir vos structures de données. Les fichiers d’entités doivent être placés dans le répertoire base44/entities/.Par exemple, créez base44/entities/task.jsonc :
{
  "name": "Task",
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "completed": {
      "type": "boolean",
      "default": false
    }
  },
  "required": ["title"]
}
5

Pousser les entités vers Base44

Poussez vos schémas d’entités vers Base44 :
base44 entities push
Cette commande synchronise vos définitions d’entités locales avec votre backend Base44, les rendant disponibles pour une utilisation dans votre application. Consultez entities push pour plus d’informations.
6

Installer le SDK Base44

Installez le SDK JavaScript Base44 :
npm install @base44/sdk
7

Créer un client Base44

Créez un client SDK Base44 dans votre projet. L’appId peut être trouvé dans votre fichier base44/.app.jsonc.Par exemple, créez lib/base44.js :
import { createClient } from '@base44/sdk';

export const base44 = createClient({
  appId: 'your-app-id-from-app.jsonc'
});
8

Utiliser le SDK dans vos routes API

Utilisez le SDK Base44 pour interagir avec vos entités dans les gestionnaires de route Hono. Par exemple :
import { Hono } from 'hono';
import { base44 } from './lib/base44Client';

const app = new Hono();

// Get all tasks
app.get('/api/tasks', async (c) => {
  const tasks = await base44.entities.Task.list();
  return c.json(tasks);
});

// Create a new task
app.post('/api/tasks', async (c) => {
  const body = await c.req.json();
  const newTask = await base44.entities.Task.create({
    title: body.title,
    completed: false
  });
  return c.json(newTask, 201);
});

export default app;
Utilisez le nom exact de l’entité de votre schéma lors de l’appel du SDK, y compris la capitalisation. Par convention, les noms d’entités commencent par une majuscule. Par exemple, si votre schéma a "name": "Task", vous y accédez avec base44.entities.Task.list().
9

Exécuter votre API localement

Démarrez votre serveur de développement Hono pour tester votre intégration. Depuis la racine de votre projet, exécutez :
npm run dev
Votre API Hono se connectera à votre backend Base44 via le client SDK, vous permettant de travailler avec vos entités déployées en temps réel.

Étapes suivantes

Maintenant que votre backend Base44 est intégré à votre projet, vous pouvez :
  • Utiliser le SDK pour ajouter plus de fonctionnalités à votre API.
  • Ajouter des entités, des fonctions backend et des agents. Si vous travaillez en TypeScript, générez des types pour obtenir l’autocomplétion et la sécurité des types.
  • Tester localement en exécutant base44 dev pour le backend Base44 aux côtés de votre serveur de développement Hono. Consultez Développement local pour les instructions de configuration.
  • Continuer à construire votre API et la déployer selon le runtime de votre choix.

Voir aussi

Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.