Cours Svelte et SvelteKit · Module 14: Hooks, API et déploiement

Routes API (+server.js)

2 min de lecture ·
Dans cette leçon3

API de base

Un fichier +server.js exporte des fonctions qui portent le nom des méthodes HTTP. Chacune reçoit la requête et renvoie un objet Response standard :

// src/routes/api/warriors/+server.js
export async function GET() {
  const warriors = await db.warriors.findMany();
  return Response.json(warriors);
}

export async function POST({ request }) {
  const data = await request.json();
  const warrior = await db.warriors.create(data);
  return Response.json(warrior, { status: 201 });
}

Response.json() fait partie de l'API Web standard : il transforme un objet en JSON et définit l'en-tête Content-Type. Dans SvelteKit 3, les utilitaires json() et text() de @sveltejs/kit sont obsolètes.

API dynamique

// src/routes/api/warriors/[id]/+server.js
import { error } from '@sveltejs/kit';

export async function GET({ params }) {
  const warrior = await db.warriors.findUnique({
    where: { id: params.id }
  });

  if (!warrior) {
    error(404, 'Introuvable');
  }

  return Response.json(warrior);
}

export async function DELETE({ params }) {
  await db.warriors.delete({
    where: { id: params.id }
  });

  return new Response(null, { status: 204 });
}

En-têtes et cookies

export async function GET({ cookies, request }) {
  // Lire le cookie
  const session = cookies.get('session');

  // Lire l'en-tête
  const auth = request.headers.get('Authorization');

  // Définir le cookie (le chemin par défaut est '/')
  cookies.set('visited', 'true', {
    httpOnly: true,
    maxAge: 60 * 60 * 24 * 7
  });

  return Response.json({ data });
}

Les endpoints API sont les portes de ta forteresse : c'est par eux que les autres applications parlent à ton serveur.

Code de cette leçon : App.svelte
<script>
  // Routes API - +server.js

  let warriors = $state([
    { id: 1, name: 'Ragnar', strength: 95 },
    { id: 2, name: 'Bjorn', strength: 90 }
  ]);

  let response = $state(null);
  let loading = $state(false);

  // Simulation de GET
  async function fetchWarriors() {
    loading = true;
    await new Promise(r => setTimeout(r, 500));
    response = { method: 'GET', data: warriors };
    loading = false;
  }

  // Simulation de POST
  async function createWarrior() {
    loading = true;
    await new Promise(r => setTimeout(r, 500));
    const newWarrior = { id: Date.now(), name: 'Ivar', strength: 85 };
    warriors = [...warriors, newWarrior];
    response = { method: 'POST', data: newWarrior, status: 201 };
    loading = false;
  }

  // Simulation de DELETE
  async function deleteWarrior() {
    if (warriors.length === 0) return;
    loading = true;
    await new Promise(r => setTimeout(r, 500));
    const deleted = warriors[warriors.length - 1];
    warriors = warriors.slice(0, -1);
    response = { method: 'DELETE', data: deleted, status: 204 };
    loading = false;
  }
</script>

<main class="api-demo">
  <h1>API Routes (+server.js)</h1>

  <section class="code">
    <h2>src/routes/api/warriors/+server.js</h2>
    <pre>
export async function GET() {"{"}
  const warriors = await db.warriors.findMany();
  return Response.json(warriors);
{"}"}

export async function POST({"{"} request {"}"}) {"{"}
  const data = await request.json();
  const warrior = await db.warriors.create(data);
  return Response.json(warrior, {"{"} status: 201 {"}"});
{"}"}

export async function DELETE({"{"} params {"}"}) {"{"}
  await db.warriors.delete(params.id);
  return new Response(null, {"{"} status: 204 {"}"});
{"}"}
    </pre>
  </section>

  <section class="test">
    <h2>Teste l’API</h2>
    <div class="buttons">
      <button onclick={fetchWarriors} disabled={loading}>
        GET /api/warriors
      </button>
      <button onclick={createWarrior} disabled={loading}>
        POST (ajoute Ivar)
      </button>
      <button onclick={deleteWarrior} disabled={loading}>
        DELETE (supprime le dernier)
      </button>
    </div>
  </section>

  {#if response}
    <section class="response">
      <h2>Réponse</h2>
      <p><strong>Méthode :</strong> {response.method}</p>
      {#if response.status}
        <p><strong>Statut :</strong> {response.status}</p>
      {/if}
      <pre>{JSON.stringify(response.data, null, 2)}</pre>
    </section>
  {/if}

  <section class="state">
    <h2>État dans la "base de données" ({warriors.length})</h2>
    {#each warriors as w}
      <div class="warrior">{w.name} ({w.strength})</div>
    {/each}
  </section>
</main>

<style>
  .api-demo {
    font-family: 'Georgia', serif;
    max-width: 600px;
    margin: 0 auto;
    padding: 2rem;
    background: #0a1628;
    color: #b8d4f7;
    min-height: 100vh;
  }

  h1 {
    color: #4a90d9;
    text-align: center;
  }

  section {
    background: rgba(74, 144, 217, 0.1);
    border: 1px solid #4a90d9;
    border-radius: 8px;
    padding: 1rem;
    margin: 1rem 0;
  }

  h2 {
    color: #4a90d9;
    font-size: 1rem;
    margin-top: 0;
  }

  pre {
    background: rgba(0,0,0,0.5);
    padding: 1rem;
    border-radius: 4px;
    font-size: 0.8rem;
    overflow-x: auto;
  }

  .buttons {
    display: flex;
    flex-direction: column;
    gap: 0.5rem;
  }

  button {
    padding: 0.75rem;
    background: #1e3a5f;
    color: #b8d4f7;
    border: 1px solid #4a90d9;
    border-radius: 4px;
    cursor: pointer;
    text-align: left;
  }

  button:disabled {
    opacity: 0.5;
  }

  strong {
    color: #ffd700;
  }

  .warrior {
    padding: 0.5rem;
    background: rgba(0,0,0,0.3);
    border-radius: 4px;
    margin-bottom: 0.25rem;
  }
</style>

Entrées de la documentation utilisées dans cette leçon

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Comment créer un endpoint GET /api/warriors ?

  1. QuestionL'endpoint GET /api/warriors

Articles utiles