Skip to content

REST-API-Integration

15 öffentliche Endpunkte mit API-Key-Auth. Funktioniert mit jeder Backend-Sprache oder -Plattform. OpenAPI 3.1 Spec inklusive.

Eigene Integration entwickeln

Wenn kein natives Modul für Ihre Plattform existiert, deckt die REST-API jeden Anwendungsfall ab.

15 Endpunkte

Index-CRUD, Dokument-CRUD (einzeln + bulk), Suche, Multi-Search, Analytics und API-Key-Management.

OpenAPI 3.1

Maschinenlesbare Spec unter /api/v1/openapi.json. Client in Python, Go, Ruby oder jeder anderen Sprache generieren.

Bearer-Token-Auth

API-Keys mit Präfix ss_search_*, ss_connector_* oder ss_scoped_*. Jeder Präfix trägt unterschiedliche Berechtigungen.

Ausgehende Webhooks (demnächst)

Webhook bei Sync-Abschluss, Quota-Alert oder abgeschlossenem Reindex empfangen. Derzeit: Connector API für Polling.

Rate-Limit-Header

X-RateLimit-Limit und X-RateLimit-Remaining Header bei jeder Antwort. Retry-After bei 429.

Versionierte API

Alle öffentlichen Endpunkte unter /api/v1. Breaking Changes erhalten ein neues Versions-Präfix. Alte Versionen werden 12 Monate lang beibehalten.

In 3 Schritten starten

Integrieren Sie AACsearch in jedes Backend mit unserer REST-API.

  1. 1

    Schritt 1

    API-Schlüssel erstellen

    Erstellen Sie einen API-Schlüssel im AACsearch-Dashboard. Navigieren Sie zu Einstellungen → API-Schlüssel → Schlüssel erstellen.

  2. 2

    Schritt 2

    Anfragen authentifizieren

    Verwenden Sie Bearer-Token-Authentifizierung. curl -H "Authorization: Bearer ss_search_..." \ https://api.aacsearch.com/v1/indexes/my-index/search

  3. 3

    Schritt 3

    Erste Anfrage stellen

    Rufen Sie den Such-Endpunkt auf. curl -X POST https://api.aacsearch.com/v1/indexes/my-index/search \ -H "Authorization: Bearer ss_search_..." \ -H "Content-Type: application/json" \ -d {"q": "running shoes", "limit": 10}

Häufig gestellte Fragen

Search OS in einem Abend starten

Erstellen Sie einen Index, fügen Sie Dokumente hinzu und verbinden Sie die Suche von Ihrer App. Free-Tier deckt ein Prototyp ab — Daten bleiben beim Upgrade erhalten.