Code HTTP 201 : Created - Ressource Créée

Le code HTTP 201 "Created" indique que la requête a abouti et qu'une nouvelle ressource a été créée sur le serveur. C'est le code de réponse approprié pour les requêtes POST (et parfois PUT) qui créent des données. Il est plus précis que le 200 car il informe explicitement le client que quelque chose de nouveau existe maintenant.

Dans une API REST bien conçue, le 201 est systématiquement accompagné d'informations permettant d'accéder à la nouvelle ressource : le header Location contenant l'URL de la ressource, et souvent le body contenant la représentation complète de ce qui a été créé. Cette réponse riche permet au client de continuer sans requête supplémentaire.

Pour le monitoring, les endpoints retournant 201 sont souvent critiques : création de commandes, inscriptions utilisateurs, soumissions de formulaires. Un 201 qui cesse de fonctionner signifie que vos utilisateurs ne peuvent plus créer de données. MoniTao permet de surveiller ces endpoints avec des requêtes POST et de vérifier le code 201.

Signification du code 201

Le code 201 transmet plusieurs informations importantes au client :

• Création confirmée : contrairement au 200 générique, le 201 confirme explicitement qu'une ressource a été créée. Le serveur ne fait pas que "réussir" la requête, il a créé quelque chose de nouveau et persistant.
• Ressource disponible : la nouvelle ressource existe et est accessible immédiatement. Si elle n'était pas encore disponible (traitement asynchrone), on utiliserait plutôt un 202 Accepted.
• Header Location : le header Location DEVRAIT contenir l'URI de la nouvelle ressource. C'est une convention REST importante qui permet au client de savoir où retrouver ce qu'il vient de créer.
• Body informatif : le body contient généralement la représentation de la ressource créée, incluant les champs générés par le serveur (ID, timestamps, etc.).

Cas d'utilisation du code 201

Voici les situations typiques où le code 201 est approprié :

• Création d'utilisateur : POST /api/users avec les données d'inscription. Le 201 confirme que le compte est créé, retourne l'ID utilisateur et l'URL du profil.
• Ajout au panier e-commerce : POST /api/cart/items pour ajouter un produit. Le 201 confirme l'ajout et retourne l'item avec son ID dans le panier.
• Soumission de formulaire : POST /api/contact-requests pour envoyer un message. Le 201 indique que la demande a été enregistrée en base.
• Upload de fichier : POST /api/files avec le fichier en multipart. Le 201 retourne les métadonnées du fichier uploadé (URL, taille, type).

Exemple d'implémentation du code 201

Voici comment implémenter correctement une réponse 201 dans votre API :

// PHP - Création d'un utilisateur
public function createUser(Request $request): Response
{
    $data = $request->getJson();

    // Validation...

    $user = User::create([
        "name" => $data["name"],
        "email" => $data["email"],
    ]);

    return new Response(
        json_encode($user),
        201, // Created
        [
            "Content-Type" => "application/json",
            "Location" => "/api/users/" . $user->id
        ]
    );
}

// Node.js / Express
app.post("/api/users", async (req, res) => {
    const user = await User.create(req.body);

    res.status(201)
       .location(`/api/users/${user.id}`)
       .json(user);
});

Notez les éléments clés : le code 201, le header Location pointant vers la nouvelle ressource, et le body contenant la représentation complète avec les champs générés (id).

Monitoring des endpoints 201

Surveiller les endpoints de création est crucial pour votre business :

• Requêtes POST avec body : MoniTao peut envoyer des requêtes POST avec un body de test pour vérifier que l'endpoint de création fonctionne. Configurez des données de test qui seront créées périodiquement.
• Vérification du code 201 : configurez le monitor pour alerter si le code retourné n'est pas 201. Un 500 ou 400 signifie que les créations échouent.
• Vérification du header Location : assurez-vous que la réponse inclut bien le header Location avec une URL valide vers la ressource créée.
• Nettoyage des données de test : créez un endpoint de test dédié qui nettoie après lui, ou utilisez des webhooks pour supprimer les ressources de test créées par le monitoring.

Questions fréquentes sur le code 201

Le 201, signature d'une API bien conçue

Utiliser correctement le code 201 est un signe de maturité API. Il fournit une information sémantique précise au client : "j'ai créé quelque chose de nouveau, voici où le trouver". Combiné avec le header Location et un body informatif, il permet au client de travailler efficacement sans requêtes supplémentaires.

MoniTao vous permet de surveiller vos endpoints de création avec des requêtes POST configurables. Vérifiez que le code 201 est retourné, que le header Location est présent, et que le temps de réponse reste acceptable. Un endpoint de création défaillant impacte directement l'acquisition et les conversions.

Prêt à dormir sur vos deux oreilles ?

Commencez gratuitement, sans carte bancaire.

Créer mon compte Voir les tarifs