Documentation API - TJM Antilles-Guyane

⚡ Démarrage rapide

Commencez à utiliser l'API en quelques minutes

🌐 URL de base

https://tjm.webmonster.tech/api/

Toutes les requêtes API utilisent cette URL de base. Aucune authentification requise.

🧪 Test rapide

curl https://tjm.webmonster.tech/api/stats

💡 Ouvrez la console du navigateur (F12) pour voir les détails des requêtes

⌨️ Raccourci : Ctrl+K pour effacer tous les résultats

📡 Endpoints disponibles

GET

/api/stats

Récupère les statistiques générales du marché TJM dans les DROM.

📝 Exemple de requête

curl -X GET "https://tjm.webmonster.tech/api/stats" \
  -H "Accept: application/json"

📊 Réponse exemple

{
  "success": true,
  "data": {
    "total_jobs": 8,
    "total_regions": 3,
    "average_tjm": 470,
    "growth_rate": "+18%",
    "last_update": "2025-08-07"
  }
}

GET

/api/tjm/{region}

Récupère tous les TJM pour une région spécifique (martinique, guadeloupe, guyane).

📝 Exemple de requête

curl -X GET "https://tjm.webmonster.tech/api/tjm/martinique" \
  -H "Accept: application/json"

📊 Réponse exemple

{
  "success": true,
  "region": "martinique",
  "last_update": "2025-08-07",
  "metiers": [
    {
      "metier": "Développeur Web",
      "tarifs": {
        "junior": "290-350€",
        "confirme": "400-500€",
        "senior": "550-650€",
        "expert": "700-750€"
      }
    }
  ]
}

GET

/api/comparison

Compare les TJM entre les trois régions DROM pour tous les métiers.

📝 Exemple de requête

curl -X GET "https://tjm.webmonster.tech/api/comparison" \
  -H "Accept: application/json"

📊 Réponse exemple

{
  "success": true,
  "comparison": {
    "Développeur Web": {
      "martinique": "290-750€",
      "guadeloupe": "280-730€", 
      "guyane": "300-780€"
    }
  }
}

GET

/api/search

Recherche des métiers par mot-clé dans toutes les régions.

📝 Paramètres

q - Terme de recherche (requis)
region - Filtrer par région (optionnel)

curl -X GET "https://tjm.webmonster.tech/api/search?q=développeur" \
  -H "Accept: application/json"

📊 Réponse exemple

{
  "success": true,
  "query": "développeur",
  "results": [
    {
      "metier": "Développeur Web",
      "regions": ["martinique", "guadeloupe", "guyane"]
    }
  ]
}

📋 Codes de réponse HTTP

200

Succès

Requête traitée avec succès

400

Requête invalide

Paramètres manquants ou incorrects

404

Non trouvé

Endpoint ou ressource inexistante

429

Limite atteinte

100 requêtes/heure maximum

💻 Exemples d'intégration

Choisissez votre langage préféré et copiez le code prêt à l'emploi

JavaScript / Fetch API

// Récupérer les TJM Martinique
async function getTjmMartinique() {
  try {
    const response = await fetch(
      'https://tjm.webmonster.tech/api/tjm/martinique'
    );
    const data = await response.json();
    
    if (data.success) {
      console.log('TJM Martinique:', data.metiers);
      return data.metiers;
    }
  } catch (error) {
    console.error('Erreur API:', error);
  }
}

// Utilisation
getTjmMartinique().then(tjms => {
  // Traiter les données TJM
  tjms.forEach(tjm => {
    console.log(`${tjm.metier}: ${tjm.tarifs.senior}`);
  });
});

PHP / cURL

<?php
// Récupérer les statistiques générales
function getTjmStats() {
    $url = 'https://tjm.webmonster.tech/api/stats';
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Accept: application/json'
    ]);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode === 200) {
        return json_decode($response, true);
    }
    
    return null;
}

// Utilisation
$stats = getTjmStats();
if ($stats && $stats['success']) {
    echo "TJM moyen: " . $stats['data']['average_tjm'] . "€";
}
?>

Python / Requests

import requests
import json

# Récupérer la comparaison inter-régionale
def get_tjm_comparison():
    url = 'https://tjm.webmonster.tech/api/comparison'
    
    try:
        response = requests.get(url, headers={
            'Accept': 'application/json'
        })
        response.raise_for_status()
        
        data = response.json()
        if data['success']:
            return data['jobs_comparison']
            
    except requests.exceptions.RequestException as e:
        print(f"Erreur API: {e}")
        return None

# Utilisation
comparison = get_tjm_comparison()
if comparison:
    for metier, regions in comparison.items():
        print(f"{metier}:")
        for region, tjm_data in regions.items():
            print(f"  {region}: {tjm_data['tarifs']['senior']}")
        print()

Node.js / Axios

const axios = require('axios');

// Rechercher des métiers
async function searchJobs(query, region = null) {
  try {
    const params = { q: query };
    if (region) params.region = region;
    
    const response = await axios.get(
      'https://tjm.webmonster.tech/api/search',
      { 
        params,
        headers: { 'Accept': 'application/json' }
      }
    );
    
    if (response.data.success) {
      return response.data.results;
    }
  } catch (error) {
    console.error('Erreur API:', error.message);
    return [];
  }
}

// Utilisation
searchJobs('développeur', 'martinique')
  .then(results => {
    console.log('Résultats de recherche:', results);
  });

cURL / Ligne de commande

# Récupérer les statistiques générales
curl -X GET "https://tjm.webmonster.tech/api/stats" \
  -H "Accept: application/json"

# Récupérer les TJM d'une région
curl -X GET "https://tjm.webmonster.tech/api/tjm/martinique" \
  -H "Accept: application/json"

# Rechercher des métiers
curl -X GET "https://tjm.webmonster.tech/api/search?q=développeur" \
  -H "Accept: application/json"

# Comparaison inter-régionale
curl -X GET "https://tjm.webmonster.tech/api/comparison" \
  -H "Accept: application/json"

# Avec formatage JSON (si jq est installé)
curl -s "https://tjm.webmonster.tech/api/stats" | jq .

⚡ Limites de l'API

Rate limiting : 100 requêtes par heure par IP
Format : JSON uniquement
CORS : Activé pour tous les domaines
Cache : Données mises à jour quotidiennement

💡 Bonnes pratiques

Gestion d'erreurs : Toujours vérifier le champ "success"
Cache local : Stocker les données pour éviter les requêtes répétées
Headers : Utiliser "Accept: application/json"
Timeout : Configurer un timeout approprié (5-10s)

🤝 Besoin d'aide ?

Notre API est gratuite et ouverte. Pour toute question ou suggestion d'amélioration.

📧 Nous contacter 🌐 Webmonster

🚀 API — TJM Antilles-Guyane

⚡ Démarrage rapide

🌐 URL de base

🧪 Test rapide

📡 Endpoints disponibles

/api/stats

📝 Exemple de requête

📊 Réponse exemple

/api/tjm/{region}

📝 Exemple de requête

📊 Réponse exemple

/api/comparison

📝 Exemple de requête

📊 Réponse exemple

/api/search

📝 Paramètres

📊 Réponse exemple

📋 Codes de réponse HTTP

💻 Exemples d'intégration

JavaScript / Fetch API

PHP / cURL

Python / Requests

Node.js / Axios

cURL / Ligne de commande

⚡ Limites de l'API

💡 Bonnes pratiques

🤝 Besoin d'aide ?