Aller au contenu principal

Démarrage rapide

Développez et testez les appels API de votre jeu dans Unity sans attendre les services backend.

Vidéo​

Le problème​

Backend en retard ? Réseau instable ? Vous voulez travailler hors ligne ? Besoin de tester les erreurs ?

  • Backend pas prêt → définissez vous-même le contrat API, construisez maintenant, basculez vers le vrai backend plus tard
  • Besoin de tester les erreurs → configurez des réponses succès/erreur/timeout/invalides à la demande
  • Développement hors ligne → jouez sans réseau, pas de VPN nécessaire
  • Test de pagination → cycles automatiques à travers différentes réponses

Routez les appels API vers :

  • Vrais backends (production, staging)
  • Serveurs QA
  • Localhost
  • Réponses mockées (codes de statut personnalisés, latence, données)

Routage API Mocking Toolkit

Installation​

  1. Ouvrez l'Unity Asset Store
  2. Recherchez "API Mocking Toolkit" → Import
  3. Importez tous les fichiers

Prérequis : Unity 2021.3+, aucune dépendance externe

Scène de démo​

1. Ouvrir la scène de démoAssets > CodeCarnage > ApiMockingToolkit > Samples > DemoScene > DemoScene.unity
2. Appuyer sur PlayLa scène se charge avec deux boutons : Get Users et Get Posts
3. Cliquer sur "Get Users"Envoie une requête → le Toolkit l'intercepte → retourne des données mockées instantanément, sans internet
4. Cliquer plusieurs fois sur "Get Posts"Cycle à travers les pages 1 → 2 → 3 → 1 (Stratégies de réponse en action)

Comment ça marche​

Ouvrez DemoController.cs :

public async void OnGetUsersClicked()
{
    var response = await ApiClient.Get("{{baseUrl}}/users");
    DisplayResponse(response);
}

Appel API standard. {{baseUrl}} se résout selon l'environnement actif. Le Toolkit intercepte les URLs correspondantes et retourne vos données mockées. Pas de vérifications if (testing). Le même code fonctionne avec les mocks ou les vrais backends.

Créez votre premier endpoint​

Mockez l'API de votre jeu en utilisant l'endpoint /comments de JSONPlaceholder comme exemple. Fonctionne hors ligne avec les mocks, ou en ligne en appelant la vraie API.

1. Ouvrir la fenêtre du toolkitWindow > CodeCarnage > API Mocking Toolkit
2. Créer un endpoint

Cliquez sur "+ Endpoint", définissez :

3. Ajouter une réponse mock

Code de statut : 201

{
"id": 501,
"postId": 1,
"name": "Demo comment from Unity",
"email": "player@example.com",
"body": "Returned from mock"
}
4. Activer le mode hors ligneActivez le bouton en haut
5. Tester
using System.Collections.Generic;
using UnityEngine;
using CodeCarnage.ApiMockingToolkit;

public class ProfileTest : MonoBehaviour
{
  async void Start()
  {
      var requestBody = "{
  "postId": 1,
  "name": "Demo comment",
  "email": "player@example.com"
}";
      var headers = new Dictionary<string, string> { { "Content-Type", "application/json" } };
      var response = await ApiClient.Post("https://jsonplaceholder.typicode.com/comments", requestBody, headers);
      Debug.Log($"Status: {response.StatusCode}");
  }
}

Prochaines étapes​

Dépannage​

Rien ne se passe ? Vérifiez que le mode hors ligne est activé, que l'URL correspond exactement (sensible à la casse), consultez la Console pour les erreurs.

La scène de démo ne fonctionne pas ? Vérifiez que "Demo Scene Collection" est sélectionnée, réimportez les Samples depuis le Package Manager.

Des questions ? Consultez la FAQ de dépannage ou envoyez un email à support@codecarnage.com