Reference API

Le Agent Skills Index fournit une API publique pour un acces programmatique.

Apercu

L'API vous permet de :

Rechercher et parcourir les competences
Obtenir les details des competences
Lister les categories
Acceder aux statistiques des competences

URL de base

https://skillsmp.com/api/v1

Authentification

La plupart des endpoints sont publics et ne necessitent pas d'authentification.

Pour les endpoints limites en debit ou specifiques a l'utilisateur, incluez une cle API :

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://skillsmp.com/api/v1/skills

Limites de debit

| Niveau | Requetes/Heure | Notes | |------|---------------|-------| | Anonyme | 100 | Pas d'auth requise | | Authentifie | 1,000 | Cle API requise | | Premium | 10,000 | Contactez-nous |

En-tetes de limite de debit :

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200

Format de reponse

Toutes les reponses sont en JSON :

json

{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Reponses d'erreur :

json

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Skill not found"
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

Endpoints

API Skills - Rechercher et recuperer des competences
API Categories - Lister et filtrer les categories
API Search - Recherche plein texte

Exemples rapides

Lister les Skills

bash

curl https://skillsmp.com/api/v1/skills

Rechercher des Skills

bash

curl "https://skillsmp.com/api/v1/skills/search?q=react"

Obtenir les details d'un Skill

bash

curl https://skillsmp.com/api/v1/skills/owner/repo

Lister les categories

bash

curl https://skillsmp.com/api/v1/categories

SDKs

JavaScript/TypeScript

bash

npm install @aiskills/sdk

typescript

import { SkillsClient } from '@aiskills/sdk';

const client = new SkillsClient();

const skills = await client.skills.list({
  category: 'development',
  limit: 10
});

Python

bash

pip install aiskills

python

from aiskills import SkillsClient

client = SkillsClient()

skills = client.skills.list(
    category='development',
    limit=10
)

Webhooks

Abonnez-vous aux evenements pour des mises a jour en temps reel :

skill.created - Nouvelle competence ajoutee
skill.updated - Contenu de competence mis a jour
skill.deleted - Competence supprimee

Contactez-nous pour l'acces aux webhooks.

Support

GitHub Issues
Email: api@skillsmp.com