API-Referenz

Service & Fähigkeiten-API

Dienstmetadaten, Fähigkeiten und Dokumentationssuche

HTTP-Referenz. Generiert aus dem Backend-Vertrag. Durchsuchen Sie die Endpunkte unten oder laden Sie OpenAPI herunter.

Diese Gruppe hat 6 Operationen, generiert aus api/openapi.yaml. Filtern Sie nach Pfad, Aktion oder Authentifizierung. Jeder Endpunkt listet seine Eingaben auf; klappen Sie ihn auf, um eine Anfragevorlage und die Antwortcodes zu sehen. Die Vorlagen brauchen Ihre eigenen Werte und einen schemagültigen Anfragekörper.

Großgeschriebene Platzhalter durch Ihre Werte ersetzen. Für eine JSON-Anfrage speichern Sie einen Body, der dem Schema in request.json entspricht. Cookie-Beispiele verwenden ein lokales Cookie-Archiv aus einer authentifizierten Sitzung.

Dienstmetadaten, Fähigkeiten und Dokumentationssuche

GET/.health

Health erhalten

Authentifizierung
keine
Anfrageinhalt
keine
Operations-ID
getHealth
Anfragevorlage und Antworten
Shell · Anfragevorlage
curl --request GET 'https://api.screenrig.ai/.health'

Antworten

StatusBedeutungTextkörper und Header
200LebendigHealthResponse (application/json)
GET/.ready

Bereitschaft erhalten

Bereitschaft zum Dienst. Ein entleerender Host antwortet mit 421 server_draining und Retry-After: 1. Ein Ausfall einer erforderlichen Abhängigkeit antwortet mit 500 not_ready und Retry-After. Ein aktives Datenbankschema, das diese Version nicht erfüllt (ein gewünschter Index fehlt oder ist länger als zwei Minuten anders), antwortet mit 500 schema_incompatible ohne Retry-After: Es wird nicht durch Warten behoben.

Authentifizierung
keine
Anfrageinhalt
keine
Operations-ID
getReadiness
Anfragevorlage und Antworten
Shell · Anfragevorlage
curl --request GET 'https://api.screenrig.ai/.ready'

Antworten

StatusBedeutungTextkörper und Header
200BereitReadyResponse (application/json)
421

Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.

RuntimeProblem (application/problem+json)
500

Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.

RuntimeProblem (application/problem+json)
GET/.version

Version erhalten

Authentifizierung
keine
Anfrageinhalt
keine
Operations-ID
getVersion
Anfragevorlage und Antworten
Shell · Anfragevorlage
curl --request GET 'https://api.screenrig.ai/.version'

Antworten

StatusBedeutungTextkörper und Header
200VersionVersionResponse (application/json)
GET/api/capabilities

Fähigkeiten abrufen

Authentifizierung
keine
Anfrageinhalt
keine
Operations-ID
getCapabilities
Anfragevorlage und Antworten
Shell · Anfragevorlage
curl --request GET 'https://api.screenrig.ai/api/capabilities'

Antworten

StatusBedeutungTextkörper und Header
200Fähigkeiten- und ArchivlimitsFähigkeiten (application/json)
GET/api/docs/search

Die offizielle Dokumentation durchsuchen

Durchsucht die offizielle screenRIG-Dokumentation, die Seiten von screenrig.ai/docs, die Problemtypen, die Preise und die übrigen Kundenseiten und liefert die am besten passenden Abschnitte, die beste zuerst, höchstens limit (standardmäßig 8). Öffentlich: Es sind keine Zugangsdaten nötig, und der Aufruf wird nie berechnet.

Die url eines Treffers ist seine Seite (mit dem Fragment des Abschnitts, wenn die Seite eines nennt), section ist die Überschrift und snippet zeigt den Text rund um den Treffer; lesen Sie die Seite oder den Abschnitt mit getDocsPage. Begrenzt auf 120 Anfragen pro Client-IP und Minute (IPv6 nach /64 gruppiert).

Der Korpus wird alle 15 Minuten neu geladen; vor dem ersten Laden antwortet die Route mit 500 not_ready und Retry-After.

Authentifizierung
keine
Anfrageinhalt
keine
Operations-ID
searchDocs

Parameter

NameSendenErforderlich?Beschreibung
qAbfrageerforderlichWörter, ein Befehl oder eine Option oder ein Fehlercode, 1 bis 200 Zeichen.
LimitAbfrageoptional
Anfragevorlage und Antworten
Shell · Anfragevorlage
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'

Antworten

StatusBedeutungTextkörper und Header
200Die passenden Abschnitte, der beste zuerst. Leer, wenn nichts passt.DocsSearchResponse (application/json); Header: RateLimit-Policy, RateLimit
Standard

Stabile RFC 9457-Fehlerantwort. Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.

Problem (application/problem+json)
429

Stabiles rate_limited-Problem. Nur nach dem autoritativen Retry-After-Intervall erneut versuchen. Ablehnungen mit festem Fenster enthalten auch die anwendbare RateLimit-Policy und RateLimit-Mitglieder; Ablehnungen wegen gleichzeitiger Nutzung und Byte-Budget enthalten diese optionalen Angaben nicht.

Problem (application/problem+json); Header: Retry-After, RateLimit-Policy, RateLimit
GET/api/docs/page

Eine Seite oder einen Abschnitt der offiziellen Dokumentation lesen

Liefert eine Seite der offiziellen Dokumentation oder, mit section, einen Abschnitt davon samt den darunterliegenden Abschnitten als Markdown. url ist die Adresse der Seite, wie searchDocs sie liefert, ihre .md-Form oder nur ihr Pfad, mit oder ohne #fragment (ein Fragment benennt den Abschnitt, wenn section nicht angegeben ist). section ist eine Überschrift oder ein Anker der Seite oder ein Teil einer Überschrift.

Ein Abschnitt wird an einem Zeilenende innerhalb von 48 KiB abgeschnitten, mit truncated true; eine ganze Seite über 48 KiB antwortet mit ihrer Einleitung und ihrer Gliederung, mit truncated true. sections listet die Überschriften auf, die als Nächstes zu lesen sind (die der Seite oder die Unterüberschriften des Abschnitts selbst). Unbekannte Seiten und Abschnitte antworten mit 404 not_found.

Öffentlich, nie berechnet und auf dieselben 120 Anfragen pro Client-IP und Minute begrenzt wie searchDocs.

Authentifizierung
keine
Anfrageinhalt
keine
Operations-ID
getDocsPage

Parameter

NameSendenErforderlich?Beschreibung
urlAbfrageerforderlichDie Adresse der Seite, 1 bis 500 Zeichen.
sectionAbfrageoptionalEine Überschrift oder ein Anker der Seite, höchstens 200 Zeichen.
Anfragevorlage und Antworten
Shell · Anfragevorlage
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'

Antworten

StatusBedeutungTextkörper und Header
200Die Seite oder der Abschnitt als Markdown.DocsPage (application/json); Header: RateLimit-Policy, RateLimit
Standard

Stabile RFC 9457-Fehlerantwort. Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.

Problem (application/problem+json)
429

Stabiles rate_limited-Problem. Nur nach dem autoritativen Retry-After-Intervall erneut versuchen. Ablehnungen mit festem Fenster enthalten auch die anwendbare RateLimit-Policy und RateLimit-Mitglieder; Ablehnungen wegen gleichzeitiger Nutzung und Byte-Budget enthalten diese optionalen Angaben nicht.

Problem (application/problem+json); Header: Retry-After, RateLimit-Policy, RateLimit