Cours Svelte et SvelteKit · Module 14: Hooks, API et déploiement
Routes API (+server.js)
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. Comment créer un endpoint GET /api/warriors ?