Skip to main content

🔌 APIs & Intégrations

RÈGLE ABSOLUE : Sans clés API, documentation complète et accès sandbox, je ne développe aucune intégration. Point final.

🚨 Ce qu'il me faut OBLIGATOIREMENT​

1. 🗝️ Clés API complètes​

Je refuse de travailler sans :

ACCÈS API COMPLETS :
Service : [Stripe, PayPal, Mailchimp, etc.]
Documentation officielle : [URL complète de la doc]

Environnement TEST/SANDBOX :
- URL API : https://api-sandbox.service.com
- Clé API : test_sk_xxxxxxxxxxxxx
- Clé publique : test_pk_xxxxxxxxxxxxx (si applicable)
- Secret webhook : whsec_xxxxxxxxxxxxx (si applicable)
- Autres identifiants : [selon service]

Environnement PRODUCTION :
- URL API : https://api.service.com
- Clé API : live_sk_xxxxxxxxxxxxx
- Clé publique : live_pk_xxxxxxxxxxxxx
- Secret webhook : whsec_xxxxxxxxxxxxx
- Autres identifiants : [selon service]

Droits/Permissions :
[ ] Lecture (GET)
[ ] Écriture (POST/PUT)
[ ] Suppression (DELETE)
[ ] Administration
[ ] Webhooks

⚠️ Si vous me donnez :

  • Seulement la clé de prod → JE REFUSE, IL ME FAUT TEST ET PROD
  • "Voici le site du service" → NON, DONNEZ-MOI LES CLÉS
  • Clés sans droits suffisants → JE VEUX ADMIN ACCESS
  • "Tu peux t'inscrire toi-même" → NON, VOUS VOUS EN OCCUPEZ

2. 📚 Documentation technique​

Obligatoire pour chaque API :

DOCUMENTATION REQUISE :
- URL documentation officielle : [lien]
- Authentification : Bearer / API Key / OAuth
- Format données : JSON / XML / autre
- Rate limiting : [requêtes/minute]
- SDK disponibles : PHP / JavaScript / autres
- Code exemples : [liens vers exemples]
- Support technique : [email/chat]

Cas d'usage spécifiques :
- Endpoint exact à utiliser : [URL]
- Méthode HTTP : GET / POST / PUT / DELETE
- Paramètres requis : [liste]
- Format réponse : [structure JSON/XML]
- Gestion erreurs : [codes erreur]

3. 🧪 Environnement de test​

Tests obligatoires avant prod :

SANDBOX/TEST REQUIS :
- Accès interface admin test
- Données de test prêtes
- Webhooks configurables
- Logs d'activité visibles
- Reset environnement possible

Exemples données test :
- Cartes bancaires test (Stripe)
- Comptes PayPal sandbox
- Emails test (Mailchimp)
- Produits fictifs (e-commerce)

🔧 Intégrations par type de service​

💳 Paiement (Stripe, PayPal, etc.)​

Stripe :

OBLIGATOIRE :
Test :
- Clé publique : pk_test_xxxxxxxxxxxxx
- Clé secrète : sk_test_xxxxxxxxxxxxx
- Webhook endpoint : À configurer
- Dashboard : https://dashboard.stripe.com/test/

Production :
- Clé publique : pk_live_xxxxxxxxxxxxx
- Clé secrète : sk_live_xxxxxxxxxxxxx
- Webhook endpoint : À configurer
- Dashboard : https://dashboard.stripe.com/

Configuration :
- Produits créés : ✅ / ❌
- Prix configurés : ✅ / ❌
- Webhooks activés : ✅ / ❌
- Mode test validé : ✅ / ❌

📧 Email Marketing (Mailchimp, SendGrid, etc.)​

Mailchimp :

OBLIGATOIRE :
- Compte Mailchimp : https://mailchimp.com/
- Clé API : xxxxxxxxxx-us1
- Audience ID : xxxxxxxxxx
- Serveur datacenter : us1, us2, etc.

Configuration :
- Listes créées : ✅ / ❌
- Champs personnalisés : ✅ / ❌
- Templates email : ✅ / ❌
- Double opt-in : Activé / Désactivé

🛒 E-commerce (WooCommerce, Shopify, etc.)​

WooCommerce API :

OBLIGATOIRE :
- URL boutique : https://monsite.com
- Consumer Key : ck_xxxxxxxxxxxxx
- Consumer Secret : cs_xxxxxxxxxxxxx
- Permissions : Read/Write
- Version API : v3 (recommandée)

Accès admin WP :
- Login : [admin]
- Mot de passe : [exact]
- URL admin : https://monsite.com/wp-admin/

📊 Analytics (Google, Facebook, etc.)​

Google Analytics :

OBLIGATOIRE :
- ID Mesure : G-XXXXXXXXXX (GA4)
- Compte Google : [email propriétaire]
- Accès Analytics : Administrateur
- API activée : Reporting API v4

Google Tag Manager :
- Container ID : GTM-XXXXXXX
- Accès GTM : Administrateur
- Variables configurées : ✅ / ❌

🧪 Tests que je vais effectuer​

1. ✅ Tests API de base​

# Test authentification
curl -H "Authorization: Bearer your-api-key" \
     https://api.service.com/test

# Test endpoint principal
curl -X GET https://api.service.com/data \
     -H "Content-Type: application/json"

# Test création ressource
curl -X POST https://api.service.com/create \
     -d '{"name":"test"}' \
     -H "Content-Type: application/json"

2. 🔍 Tests fonctionnels​

  • Création/modification/suppression d'éléments
  • Gestion des erreurs (rate limit, auth failed)
  • Webhooks (réception et traitement)
  • Pagination des résultats
  • Gestion des timeouts

3. 📊 Tests de performance​

  • Temps de réponse API
  • Respect des rate limits
  • Comportement en cas de panne
  • Fallback si API indisponible

🚫 Ce que je ne fais PAS​

❌ Développement à l'aveugle​

  • "Intègre cette API" sans clés → IMPOSSIBLE
  • "Ça devrait marcher" → JE TESTE AVANT
  • Dev en prod direct → SANDBOX D'ABORD

❌ Support API tiers​

  • "Pourquoi l'API répond pas ?" → CONTACTEZ LEUR SUPPORT
  • "Aide à configurer leur compte" → PAS MON JOB
  • Formation sur leurs outils → VOUS VOUS FORMEZ

❌ Intégration sans documentation​

  • API sans doc → INACCEPTABLE
  • "Tu verras bien" → NON
  • Reverse engineering → DONNEZ-MOI LA DOC

💰 Facturation API​

🕐 Temps standard​

  • Intégration simple (CRUD) : 4-8 heures
  • Paiement (Stripe/PayPal) : 8-16 heures
  • Email marketing : 4-8 heures
  • API complexe custom : 1-3 jours
  • Webhooks + gestion erreurs : +4-8 heures

⏰ Temps supplémentaire si :​

  • Documentation incomplète → +50% temps
  • API mal conçue → +100% temps
  • Pas d'environnement test → +4h minimum
  • Support API défaillant → +2-8h

💸 Facturation spéciale​

  • R&D API non documentée : 200€/jour
  • API legacy/obsolète : +100% tarif
  • Migration API : 150€/h
  • Maintenance API : 100€/h

📋 Checklist avant intégration​

Avant toute demande d'intégration API :

  • Clés API TEST et PROD fournies et testées
  • Documentation complète accessible
  • Environnement sandbox configuré
  • Webhooks configurables si nécessaire
  • Compte admin avec tous les droits
  • Support technique disponible
  • Budget validé selon complexité
  • Planning réaliste défini

🚨 Problèmes API fréquents​

🔴 401 Unauthorized​

Cause : Clé API incorrecte ou expirée Solution : Vérifiez la clé, régénérez si nécessaire

🔴 429 Too Many Requests​

Cause : Rate limit dépassé Solution : Implémentation retry logic + respect limites

🔴 500 Internal Server Error​

Cause : Problème côté API Solution : Contactez le support du service

🔴 Webhook non reçu​

Cause : URL incorrecte ou serveur inaccessible Solution : Vérifiez l'URL et la configuration serveur

🎯 Processus de demande API​

1. 🎫 Créer un ticket avec :​

TITRE : [API] Intégration [NOM SERVICE] - [PROJET]

SERVICE API :
- Nom : Stripe / PayPal / Mailchimp / autre
- Version : v3 / v2 / latest
- Documentation : [URL]

FONCTIONNALITÉS SOUHAITÉES :
[ ] Création d'éléments
[ ] Modification/mise à jour
[ ] Suppression
[ ] Listing/recherche
[ ] Webhooks
[ ] Autre : [préciser]

ACCÈS FOURNIS :
- Clés TEST : ✅ / ❌
- Clés PROD : ✅ / ❌
- Sandbox configuré : ✅ / ❌
- Documentation : ✅ / ❌

DÉLAI SOUHAITÉ : [date]
BUDGET : [forfait / au temps passé]

2. ⏱️ Réponse sous 4h​

  • Validation des accès API
  • Estimation temps développement
  • Planning détaillé

3. 🔧 Développement​

  • Tests en sandbox
  • Développement fonctionnalités
  • Tests de robustesse
  • Documentation technique

🎯 Récapitulatif​

Pour toute intégration API :

  1. CLÉS COMPLÈTES (test + production)
  2. DOCUMENTATION officielle accessible
  3. SANDBOX configuré et fonctionnel
  4. TESTS systématiques avant prod
  5. SUPPORT technique disponible

Sans ces éléments = pas de développement.

⚠️ RAPPEL : Une API sans clés = une API que je n'intègre pas. Une API sans doc = une API que je refuse. Point final.