>_

API-Referenz

Der Agent Skills Index bietet eine öffentliche API für programmatischen Zugriff.

Überblick

Die API ermöglicht Ihnen:

  • Skills suchen und durchsuchen
  • Skill-Details abrufen
  • Kategorien auflisten
  • Auf Skill-Statistiken zugreifen

Basis-URL

https://skillsmp.com/api/v1

Authentifizierung

Die meisten Endpunkte sind öffentlich und erfordern keine Authentifizierung.

Für ratenbegrenzte oder benutzerspezifische Endpunkte fügen Sie einen API-Schlüssel hinzu:

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

Rate-Limits

| Stufe | Anfragen/Stunde | Hinweise | |------|---------------|-------| | Anonym | 100 | Keine Authentifizierung erforderlich | | Authentifiziert | 1.000 | API-Schlüssel erforderlich | | Premium | 10.000 | Kontaktieren Sie uns |

Rate-Limit-Header:

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

Antwortformat

Alle Antworten sind JSON:

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

Fehlerantworten:

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

Endpunkte

Schnelle Beispiele

Skills auflisten

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

Skills suchen

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

Skill-Details abrufen

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

Kategorien auflisten

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

Abonnieren Sie Events für Echtzeit-Updates:

  • skill.created - Neuer Skill hinzugefügt
  • skill.updated - Skill-Inhalt aktualisiert
  • skill.deleted - Skill entfernt

Kontaktieren Sie uns für Webhook-Zugang.

Support

Diese Seite auf GitHub bearbeiten