Findstack Dokumentacja API

Findstack Katalog jest czytelny zarówno dla maszyn, jak i ludzi. Produkty, kategorie, ceny, funkcje i integracje są dostępne za pośrednictwem publicznego interfejsu API REST, serwera MCP oraz reprezentacji Markdown każdej strony katalogu. Odczyt nie wymaga uwierzytelnienia.

Findstack REST API

Podstawowy adres URL https://findstack.com/api/v1Odpowiedzi są w formacie JSON. Pobranie tego bazowego adresu URL zwraca indeks każdego punktu końcowego, limitu i polityki poniżej — zacznij od tego, jeśli jesteś programem.

curl https://findstack.com/api/v1/products?q=crm&per_page=5

GET /products — wyszukiwanie i filtrowanie produktów
GET /products/{slug} — pełny opis produktu, w tym plany cenowe
GET /products/{slug}/integrations — z czym łączy się produkt
GET /categories — przeglądaj lub przeszukaj kategorie
GET /categories/{slug} — szczegóły kategorii z podkategoriami
GET /categories/{slug}/products — produkty w ramach kategorii

Produkty można filtrować według q, category, tech_stack, segment, free_plan, has_api, has_ai oraz open_sourcei posortowane według rating, reviews, popularity, newest or name.

Pełny kontrakt opisano w OpenAPI 3.1 w pliku /openapi.json i skatalogowano zgodnie z RFC 9727 w pliku /.well-known/api-catalog.

Limity stawek

120 żądań na 60 sekund na adres IP, współdzielonych przez każdy punkt końcowy. Każda odpowiedź informuje o Twojej sytuacji, dzięki czemu możesz dostosować tempo żądań zamiast odkrywać limit, po prostu go osiągając:

RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
RateLimit-Policy: "catalog";q=120;w=60
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — te same liczby jako oddzielne pola, odbite lustrzanie jako X-RateLimit-*
Retry-After — sekund oczekiwania, wysłane tylko na 429

Błędy

Każda porażka pod /api to JSON, nigdy strona HTML — wliczając w to nieznane ścieżki i nieoczekiwane błędy serwera. Rozgałęzienie code, który jest stabilny; message oraz hint są dla kłód i ludzi.

{
  "error": {
    "code": "not_found",
    "message": "No such resource",
    "hint": "Check the slug. Search endpoints return the slugs the detail endpoints accept.",
    "documentation_url": "https://findstack.com/developers"
  }
}

Kody w użyciu: not_found, rate_limited, internal_error. Strony zewnętrzne /api odpowiedz na kod 404 w Markdown, gdy klient nie prosi o HTML, podając linki do mapy witryny, pliku llms.txt i tej strony.

Polityka wersjonowania i wycofywania

Wersja znajduje się w ścieżce i v1 jest aktualna. Każda odpowiedź niesie ze sobą również X-API-VersionZmiany dodatkowe — nowe pole, nowy punkt końcowy, nowy filtr — są wprowadzane do bieżącej wersji bez ostrzeżenia, dlatego analizuj dane defensywnie i ignoruj pola, których nie rozpoznajesz.

Zmiany powodujące przerwanie działania są wysyłane jako nowa wersja ścieżki. W takim przypadku zastąpiona wersja odpowiada przez co najmniej 180 dni i ogłasza wycofanie z użytku przy każdej odpowiedzi:

Deprecation — data wycofania wersji (RFC 9745)
Sunset — data, w której przestaje odpowiadać (RFC 8594), nigdy nie wcześniej niż 180 dni po Deprecation dane
Link: <https://findstack.com/developers#versioning>; rel="deprecation" — wysyłane w każdej odpowiedzi, wskazujące tutaj

Nie Deprecation or Sunset Nagłówek oznacza, że nic nie jest zaplanowane. Forma tej polityki, którą można odczytać maszynowo, to versioning obiekt w /api/v1.

Findstack Serwer MCP

Agenci AI mogą się łączyć https://findstack.com/mcp przez protokół Model Context Protocol (strumieniowy transport HTTP, brak uwierzytelniania). Dostępne narzędzia: search_products, get_product, compare_products, find_alternatives, list_categories oraz get_category.

Serwer publikuje również zasoby — indeks kategorii katalogu ze ślimakami, opis OpenAPI tego interfejsu API, llms.txtoraz dwie poniższe umiejętności agenta — a także szablony zasobów, które odpowiadają dowolnej stronie produktu lub kategorii według ślimaka. Przeczytaj je przed wywołaniem narzędzi; oszczędzą Ci zgadywania.

Karta serwera jest w /.znany/mcp (również serwowane w /.well-known/mcp/server-card.json).

Reprezentacje Markdown

Każda strona produktu, kategorii, porównania, przewodnika i artykułu zwraca kod Markdown zamiast HTML na żądanie Accept: text/markdownlub poprzez dodanie .md do ścieżki. Markdown to ta sama treść bez nawigacji, reklam i skryptów — łatwiejsza do cytowania i tańsza w czytaniu.

Umiejętności agenta

Dwie opublikowane umiejętności dokumentują, jak dobrze korzystać z katalogu – wyszukiwanie oprogramowania i porównywanie listy skrótów. Są one indeksowane w katalogu /.well-known/agent-skills/index.json.

Korzystanie z danych

Dane katalogowe mogą być wykorzystywane do udzielania odpowiedzi na pytania i odpowiedzi sztucznej inteligencji, z przypisaniem do Findstack i link do strony kanonicznej. Masowe ponowne wykorzystanie do szkolenia modelu nie jest dozwolone — nasze sygnały treści są publikowane w robots.txt.

Ogłoszenia są niezależne pod względem redakcyjnym, a niektóre z nich mają powiązania partnerskie — zobacz nasze ujawnienie oraz metodologiaPytania: Witaj@findstack.com.