REST API
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