Tests Manuels

Guide complet pour tester manuellement votre API avec cURL, navigateur, et Postman.

Les tests manuels permettent de valider rapidement le comportement de l’API avant d’écrire des tests automatisés.

Prérequis

L’application doit être lancée sur http://localhost:8080


# Démarrer l'application
./mvnw mn:run
 
# Ou avec Gradle
./gradlew run

1. Tests avec cURL

cURL est l’outil en ligne de commande le plus rapide pour tester une API REST.

Cas Valides (200 OK)

Requête Basique

Test 1.1 - Requête Basique


curl "http://localhost:8080/api/trends?keyword=java&region=US"

Résultat attendu :


{
  "keyword": "java",
  "region": "US",
  "trends": [
    {
      "keyword": "java",
      "value": 85,
      "date": "2025-01-15"
    }
  ]
}

Status : 200 OK

Keyword avec Espaces

Test 1.2 - Keyword avec Espaces


curl "http://localhost:8080/api/trends?keyword=machine%20learning&region=FR"

Les espaces doivent être encodés en %20 dans les URLs.

Résultat attendu : 200 OK avec keyword normalisé

Tirets et Underscores

Test 1.3 - Keyword avec Tirets et Underscores


curl "http://localhost:8080/api/trends?keyword=spring-boot_tutorial&region=GB"

Résultat attendu : 200 OK

Note : Les tirets - et underscores _ sont autorisés dans les keywords.

Région par Défaut

Test 1.4 - Région par Défaut


curl "http://localhost:8080/api/trends?keyword=python"

Résultat attendu : 200 OK avec region=US (valeur par défaut)

Si region n’est pas fourni, la valeur par défaut US est utilisée.

Erreurs de Validation (400 Bad Request)

Les erreurs de validation sont gérées automatiquement par Micronaut via les annotations @NotBlank, @Size, @Pattern.

Caractères Spéciaux

Test 2.1 - Keyword avec Caractères Spéciaux


curl "http://localhost:8080/api/trends?keyword=java%26é%225854&region=US"

Résultat attendu :


{
  "message": "Bad Request",
  "_embedded": {
    "errors": [
      {
        "message": "keyword: Keyword must contain only alphanumeric characters, spaces, hyphens and underscores"
      }
    ]
  }
}

Status : 400 Bad Request

Les caractères spéciaux &, é, " ne sont pas autorisés.

Keyword Trop Court

Test 2.2 - Keyword Trop Court (< 2 caractères)


curl "http://localhost:8080/api/trends?keyword=a&region=US"

Résultat attendu :


{
  "message": "Bad Request",
  "_embedded": {
    "errors": [
      {
        "message": "keyword: Keyword must be between 2 and 100 characters"
      }
    ]
  }
}

Status : 400 Bad Request

Keyword Vide

Test 2.3 - Keyword Vide


curl "http://localhost:8080/api/trends?keyword=&region=US"

Résultat attendu :


{
  "message": "Bad Request",
  "_embedded": {
    "errors": [
      {
        "message": "keyword: Keyword cannot be empty"
      }
    ]
  }
}

Status : 400 Bad Request

Région Invalide

Test 2.5 - Région Invalide (Trop Longue)


curl "http://localhost:8080/api/trends?keyword=java&region=FRANCE"

Résultat attendu :


{
  "message": "Bad Request",
  "_embedded": {
    "errors": [
      {
        "message": "region: Region must be a 2-letter country code"
      },
      {
        "message": "region: Region must be a valid 2-letter uppercase country code (e.g., US, FR, GB)"
      }
    ]
  }
}

Status : 400 Bad Request

La région doit être un code pays à 2 lettres en majuscules (ISO 3166-1 alpha-2).

Violations Multiples

Micronaut retourne toutes les erreurs de validation en une seule réponse.


curl "http://localhost:8080/api/trends?keyword=a&region=usa"

Résultat attendu :


{
  "message": "Bad Request",
  "_embedded": {
    "errors": [
      {
        "message": "keyword: Keyword must be between 2 and 100 characters"
      },
      {
        "message": "region: Region must be a valid 2-letter uppercase country code (e.g., US, FR, GB)"
      }
    ]
  }
}

Avantages :

✅ L’utilisateur voit toutes les erreurs en une seule requête
✅ Meilleure expérience utilisateur
✅ Moins d’allers-retours HTTP

2. Tests avec le Navigateur

Le navigateur est idéal pour tester rapidement des requêtes GET et voir le JSON formaté.

Cas Valide


http://localhost:8080/api/trends?keyword=java&region=FR

Résultat : JSON affiché dans le navigateur

Keyword Invalide


http://localhost:8080/api/trends?keyword=java&é"123&region=US

Résultat : Erreur 400 avec message clair

Région Invalide


http://localhost:8080/api/trends?keyword=java&region=FRANCE

Résultat : Erreur 400 avec explications

3. Tests avec Postman / Insomnia

Postman et Insomnia offrent une interface graphique pour organiser et sauvegarder vos tests.

Configuration de Base

Créer une requête GET

Method : GET
URL : http://localhost:8080/api/trends

Ajouter les Query Params

Param	Value	Description
`keyword`	`java`	Mot-clé à rechercher
`region`	`US`	Code pays (optionnel, défaut: US)

Envoyer la requête

Cliquer sur Send et vérifier la réponse.

Créer des tests pour différents cas

Dupliquer la requête pour tester :

✅ Cas valides
❌ Keyword invalide
❌ Région invalide
❌ Paramètres manquants

Collection Postman Recommandée

Cas Valides

Cas Valides (200)

Nom	keyword	region	Résultat Attendu
Basic Request	`java`	`US`	200 OK
With Spaces	`machine learning`	`FR`	200 OK
With Hyphens	`spring-boot`	`GB`	200 OK
Default Region	`python`	(vide)	200 OK, region=US

Erreurs 400

Erreurs de Validation (400)

Nom	keyword	region	Erreur Attendue
Special Characters	`java@#$`	`US`	Keyword invalid
Too Short	`a`	`US`	Min 2 characters
Empty Keyword	(vide)	`US`	Cannot be empty
Invalid Region	`java`	`FRANCE`	Must be 2 letters
Lowercase Region	`java`	`fr`	Must be uppercase

Erreurs 404

Ressource Non Trouvée (404)

Pour tester les erreurs 404, vous devez modifier temporairement le code.

Modification du MockTrendRepositoryAdapter


@Override
public Optional<TrendResult> getTrends(TrendQuery query) {
    // Simuler un "non trouvé"
    if (query.keyword().equals("notfound")) {
        return Optional.empty();
    }
    // ... reste du code
}

Test dans Postman

keyword : notfound
region : US

Résultat attendu :


{
  "status": 404,
  "error": "Not Found",
  "message": "No trends found for keyword 'notfound' in region 'US'",
  "timestamp": "2025-01-15T10:30:00",
  "path": "/api/trends"
}

Erreurs 500

Erreur Serveur (500)

Pour tester les erreurs 500, vous devez modifier temporairement le controller.

Modification du TrendController


@Get
public TrendResponseDto getTrends(...) {
    if (keyword.equals("crash")) {
        throw new RuntimeException("Simulated server error");
    }
    // ... reste du code
}

Test dans Postman

keyword : crash
region : US

Résultat attendu :


{
  "status": 500,
  "error": "Internal Server Error",
  "message": "Simulated server error",
  "timestamp": "2025-01-15T10:30:00",
  "path": "/api/trends"
}

Important : Vérifier que la stack trace Java n’est PAS exposée au client (seulement dans les logs serveur).

4. Vérification des Logs Serveur

Les logs serveur contiennent des informations détaillées sur les erreurs (stack traces, contexte).

Erreurs de Validation (400)


ERROR - Exception caught for request: GET /api/trends
jakarta.validation.ConstraintViolationException: keyword: Keyword must contain only alphanumeric characters...

Ressource Non Trouvée (404)


ERROR - Exception caught for request: GET /api/trends
org.smoka.application.exception.ResourceNotFoundException: No trends found for keyword 'notfound' in region 'US'

Erreur Serveur (500)


ERROR - Unhandled exception for GET /api/trends
java.lang.RuntimeException: Simulated server error
    at org.smoka.adapter.input.TrendController.getTrends(TrendController.java:42)
    at org.smoka.adapter.input.$TrendController$Definition$Exec.dispatch(Unknown Source)
    ...
[Stack trace complète - visible SEULEMENT côté serveur]

Règle d’or : Les stack traces complètes sont dans les logs serveur, JAMAIS exposées au client.

5. Matrice de Tests

Utilisez cette matrice pour couvrir tous les cas importants.

#	Type de Test	Code HTTP	Géré par	Priorité
1.x	Requêtes valides	200	Controller	⭐⭐⭐
2.x	Validations échouées	400	Micronaut	⭐⭐⭐
3.x	Ressource non trouvée	404	GlobalExceptionHandler	⭐⭐
4.x	Erreur serveur	500	GlobalExceptionHandler	⭐

6. Checklist de Validation

7. Automatisation des Tests Manuels

Une fois les tests manuels validés, automatisez-les avec des tests d’intégration !

Exemple : Automatiser un Test cURL

Test manuel :


curl "http://localhost:8080/api/trends?keyword=java&region=US"

Test automatisé :


@MicronautTest
class TrendControllerIntegrationTest {
 
    @Inject
    HttpClient client;
 
    @Test
    void shouldReturnTrendsForValidRequest() {
        var response = client.toBlocking().exchange(
            "/api/trends?keyword=java&region=US",
            TrendResponseDto.class
        );
 
        assertEquals(HttpStatus.OK, response.status());
        assertNotNull(response.body());
    }
}

Les tests automatisés permettent de détecter les régressions à chaque commit.

Récapitulatif

Les tests manuels sont essentiels pour valider rapidement le comportement de l’API avant d’écrire des tests automatisés.

Outils Recommandés

Outil	Avantages	Quand l’Utiliser
cURL	⚡ Ultra rapide, scriptable	Tests rapides, CI/CD
Navigateur	👀 Visuel, JSON formaté	Tests exploratoires
Postman	💾 Sauvegarde collections, interface graphique	Tests organisés, documentation

Règles d’Or

Testez d’abord manuellement avant d’automatiser
Vérifiez les logs pour chaque cas d’erreur
Organisez vos tests en collections (Postman)
Automatisez les cas critiques dès que possible

Prochaines Étapes

Vous savez maintenant tester manuellement votre API. Passez aux tests automatisés !

📖 Tests d’Intégration - Automatiser les tests avec @MicronautTest
📖 Tests Unitaires - Tester la logique métier
📖 Stratégies de Test - Quand utiliser quel type de test
📖 Gestion des Exceptions - Implémenter le GlobalExceptionHandler

Tests Manuels

Prérequis

1. Tests avec cURL

Cas Valides (200 OK)

Requête Basique

Keyword avec Espaces

Tirets et Underscores

Région par Défaut

Erreurs de Validation (400 Bad Request)

Caractères Spéciaux

Keyword Trop Court

Keyword Vide

Région Invalide

Violations Multiples

2. Tests avec le Navigateur

Cas Valide

Keyword Invalide

Région Invalide

3. Tests avec Postman / Insomnia

Configuration de Base

Créer une requête GET

Ajouter les Query Params

Envoyer la requête

Créer des tests pour différents cas

Collection Postman Recommandée

Cas Valides

Erreurs 400

Erreurs 404

Modification du MockTrendRepositoryAdapter

Test dans Postman

Erreurs 500

Modification du TrendController

Test dans Postman

4. Vérification des Logs Serveur

Erreurs de Validation (400)

Ressource Non Trouvée (404)

Erreur Serveur (500)

5. Matrice de Tests

6. Checklist de Validation

Tester les cas valides (200)

Tester les erreurs de validation (400)

Tester les erreurs métier (404)

Tester les erreurs serveur (500)

Vérifier les logs

7. Automatisation des Tests Manuels

Exemple : Automatiser un Test cURL

Récapitulatif

Outils Recommandés

Règles d’Or

Prochaines Étapes