Aller au contenu principal

Postman Collections

Collections Postman pour tester l API MyTV v2.

Collections Disponibles​

CollectionEndpointsDescription
MyTelevision_API_Collection.json179API publique v2
MyTelevision_Admin_Collection.json150+API Administration
MyTelevision_Account_Profile_Collection.json50+Comptes & Profils

Environnements​

environments/
├── local.json        # Developpement local
├── staging.json      # Environnement staging
└── production.json   # Production (read-only recommande)

Import & Configuration​

1. Importer les Collections​

  1. Ouvrir Postman
  2. Cliquer "Import"
  3. Selectionner les fichiers JSON des collections

2. Importer l Environnement​

  1. Aller dans "Environments"
  2. Cliquer "Import"
  3. Selectionner local.json ou staging.json
  4. Selectionner l environnement actif

3. Configurer les Variables​

baseUrl:      http://localhost:3000
apiUrl:       {{baseUrl}}/api/v2
adminUrl:     {{baseUrl}}/api/v2/admin
accessToken:  (auto-rempli apres login)
refreshToken: (auto-rempli apres login)

Utilisation​

Authentification​

  1. Ouvrir la collection "Auth"
  2. Executer "Login" avec les credentials
  3. Les tokens sont automatiquement sauvegardes
  4. Toutes les autres requetes utilisent ces tokens

Scripts de Test​

Chaque requete inclut des tests automatiques :

pm.test('Status code is 200', function () {
  pm.response.to.have.status(200);
});

pm.test('Response has data', function () {
  var jsonData = pm.response.json();
  pm.expect(jsonData).to.have.property('data');
});

Variables Dynamiques​

Les reponses sont parsees pour extraire les IDs :

// Post-response script
var jsonData = pm.response.json();
pm.environment.set('movieId', jsonData.data.id);

Organisation des Collections​

API Publique​

MyTelevision_API_Collection/
├── Auth/
│   ├── Login
│   ├── Register
│   ├── Refresh Token
│   ├── Social Google
│   └── Logout
├── Accounts/
│   ├── Get Account
│   ├── Login (2-step)
│   ├── Select Profile
│   └── Account Deletion
├── Profiles/
│   ├── List Profiles
│   ├── Create Profile
│   ├── Create Kids Profile
│   ├── Switch Profile
│   └── PIN Management
├── Movies/
│   ├── List Movies
│   ├── Get Movie
│   ├── Featured
│   └── Top Ten
├── Series/
│   ├── List Series
│   ├── Get Series
│   ├── Get Seasons
│   └── Get Episodes
├── Live TV/
├── Radio/
├── Podcasts/
├── News/
├── Events/
├── Streaming/
│   ├── Generate Token
│   ├── Verify Token
│   └── Revoke Token
├── Engagement/
│   ├── Reactions
│   ├── Views
│   ├── Favorites
│   └── Watch History
└── Settings/

API Admin​

MyTelevision_Admin_Collection/
├── Users/
├── Movies CRUD/
├── Series CRUD/
├── Live TV CRUD/
├── Radio CRUD/
├── Podcasts CRUD/
├── News CRUD/
├── Events CRUD/
├── Categories/
├── Genres/
├── Settings/
├── Subscriptions/
└── Reports/

Bonnes Pratiques​

  1. Toujours login en premier pour obtenir les tokens
  2. Utiliser l environnement correspondant
  3. Ne pas commiter les tokens dans les collections
  4. Executer les tests pour valider les reponses
  5. Documenter les nouveaux endpoints ajoutes

Exporter les Collections​

Apres modifications :

# Exporter depuis Postman et copier dans le repo
cp ~/Downloads/collection.json ./postman/

Runner Postman (CI/CD)​

# Avec Newman
npm install -g newman

# Executer la collection
newman run MyTelevision_API_Collection.json \
  -e environments/staging.json \
  --reporters cli,junit \
  --reporter-junit-export results.xml