Such-API

Volltextsuche über alle Skills.

Skills suchen

GET /api/v1/skills/search

Parameter

| Parameter | Typ | Beschreibung | |-----------|------|-------------| | q | string | Suchanfrage (erforderlich) | | page | number | Seitennummer (Standard: 1) | | limit | number | Elemente pro Seite (Standard: 20) | | category | string | Nach Kategorie filtern | | platform | string | Nach Plattform filtern | | minStars | number | Minimale Stern-Anzahl | | hasIndex | boolean | Hat marketplace.json |

Beispielanfrage

bash

curl "https://skillsmp.com/api/v1/skills/search?q=react+typescript&category=frontend&minStars=100"

Beispielantwort

json

{
  "data": [
    {
      "id": "456",
      "owner": "community",
      "repo": "react-typescript-guide",
      "name": "React TypeScript Guide",
      "description": "Type-safe React development patterns",
      "stars": 890,
      "score": 15.7,
      "highlights": {
        "name": "<mark>React</mark> <mark>TypeScript</mark> Guide",
        "description": "Type-safe <mark>React</mark> development patterns"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "totalPages": 3
  },
  "meta": {
    "query": "react typescript",
    "took": 23
  }
}

Suchsyntax

Einfache Suche

react components

Durchsucht alle Textfelder nach diesen Begriffen.

Exakte Phrase

"react hooks"

Findet die exakte Phrase.

Feldspezifisch

name:react description:hooks

Durchsucht bestimmte Felder.

Ausschluss

react -class

Schließt Begriffe mit Minus aus.

Platzhalter

react*

Präfix-Suche.

Suchtipps

Effektive Anfragen

Gut:

react hooks state management - Spezifische Begriffe
"code review" security - Phrase + Begriff
typescript name:react - Feldspezifisch

Weniger effektiv:

the best react skill - Stoppwörter werden ignoriert
r - Zu kurz
* - Zu breit

Relevanz-Bewertung

Ergebnisse werden bewertet nach:

Exakte Übereinstimmung - Vollständige Begriffsübereinstimmungen
Feldgewichtung - Name > Beschreibung > Inhalt
Popularität - Boost durch Stern-Anzahl
Aktualität - Boost durch kürzliche Updates

Autovervollständigung

GET /api/v1/skills/autocomplete

Parameter

| Parameter | Typ | Beschreibung | |-----------|------|-------------| | q | string | Teilweise Anfrage | | limit | number | Max. Vorschläge (Standard: 5) |

Beispielanfrage

bash

curl "https://skillsmp.com/api/v1/skills/autocomplete?q=rea"

Beispielantwort

json

{
  "data": [
    {
      "text": "react",
      "count": 89
    },
    {
      "text": "react hooks",
      "count": 34
    },
    {
      "text": "react typescript",
      "count": 28
    }
  ]
}

Fehlerbehandlung

| Code | Beschreibung | |------|-------------| | INVALID_QUERY | Anfrage ist leer oder zu kurz | | QUERY_TOO_LONG | Anfrage überschreitet 200 Zeichen | | INVALID_SYNTAX | Fehlerhafte Suchsyntax |