OpenAPI YAMLOpenAPI JSONProbleme YAMLAPI-Überblick
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
Health erhalten
Anfragevorlage und Antworten
curl --request GET 'https://api.screenrig.ai/.health'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Lebendig | HealthResponse (application/json) |
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.
Anfragevorlage und Antworten
curl --request GET 'https://api.screenrig.ai/.ready'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Bereit | ReadyResponse (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) |
Version erhalten
Anfragevorlage und Antworten
curl --request GET 'https://api.screenrig.ai/.version'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Version | VersionResponse (application/json) |
Fähigkeiten abrufen
Anfragevorlage und Antworten
curl --request GET 'https://api.screenrig.ai/api/capabilities'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Fähigkeiten- und Archivlimits | Fähigkeiten (application/json) |
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.
Parameter
| Name | Senden | Erforderlich? | Beschreibung |
|---|---|---|---|
| q | Abfrage | erforderlich | Wörter, ein Befehl oder eine Option oder ein Fehlercode, 1 bis 200 Zeichen. |
| Limit | Abfrage | optional |
Anfragevorlage und Antworten
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Die 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 |
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.
Parameter
| Name | Senden | Erforderlich? | Beschreibung |
|---|---|---|---|
| url | Abfrage | erforderlich | Die Adresse der Seite, 1 bis 500 Zeichen. |
| section | Abfrage | optional | Eine Überschrift oder ein Anker der Seite, höchstens 200 Zeichen. |
Anfragevorlage und Antworten
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Die 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 |