Documentation API

Accédez aux données SkillsMP Skills par programmation via notre API REST. Recherche par mots-clés avec filtres par catégorie, profession et langue détectée du contenu des Skills.

table_of_contents.md

Authentification

Points de terminaison

GET /api/v1/skills/search

Rechercher des skills par mots-clés

Paramètre	Type	Requis	Description
q	string	✓	Requête de recherche
page	number	-	Numéro de page (défaut : 1)
limit	number	-	Éléments par page (défaut : 20, max : 100)
sortBy	string	-	Tri : stars \| recent (défaut : recent)
category	string	-	Filtrer par slug de catégorie (ex. data-ai, devops).
occupation	string	-	Filtrer par slug de métier SOC (ex. software-developers).
language	string	-	Filtrer selon la langue détectée du contenu du Skill. Utilisez un code ISO comme en, zh ou ja ; mul sélectionne le contenu multilingue et und le contenu dont la langue est indéterminée.

Limites de débit

*Anonyme (sans clé API) : 50 requêtes/jour, 10/min — recherche par mots-clés uniquement
*Authentifié (avec clé API) : 500 requêtes/jour, 30/min — recherche par mots-clés
*Les recherches par caractère générique (ex. *) ne sont pas prises en charge

Chaque réponse API inclut les en-têtes suivants pour vous aider à suivre votre consommation :

En-tête	Description
X-RateLimit-Daily-Limit	Limite quotidienne de requêtes
X-RateLimit-Daily-Remaining	Requêtes restantes pour aujourd'hui

Exemples de code

Recherche par mots-clés

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
  -H "Authorization: Bearer sk_live_your_api_key"

Recherche avec filtre métier

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=automation&occupation=software-developers&language=zh&sortBy=stars" \
  -H "Authorization: Bearer sk_live_your_api_key"

Gestion des erreurs

L'API utilise les codes d'état HTTP standard et retourne les détails d'erreur au format JSON.

Code d'erreur	HTTP	Description
INVALID_API_KEY	401	Clé API invalide
MISSING_QUERY	400	Paramètre de requête manquant
INVALID_OCCUPATION	400	Slug de métier inconnu
INVALID_LANGUAGE	400	Code de langue du contenu inconnu
DAILY_QUOTA_EXCEEDED	429	Quota quotidien API dépassé
INTERNAL_ERROR	500	Erreur interne du serveur

Exemple de réponse d'erreur :

json

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

more.md

Retour à la documentation