Skip to main content
PATCH
Einstellungen aktualisieren
PATCH https://api-datahub.octoparse.com/v1/data-apps/{app_id}/settings Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>). Nur App-Autor; andere erhalten 404. Umkehrbarer Betriebszustand auf App-Ebene, unabhängig vom Lebenszyklus – jederzeit anpassbar:
  • scope: public im Markt sichtbar / private nur für den Autor / shared Grant-Liste (die Liste über die Grant-Endpoints pflegen).
  • accepting_runs: Wartungsschalter. false bedeutet „in Wartung“; neue Runs anderer werden abgelehnt (403 app-not-accepting-runs, message enthält pause_message). Bestehende Runs, gekaufte Daten und die Sichtbarkeit im Markt bleiben unberührt; Selbsttests des Autors sind nicht eingeschränkt. Nach der Wiederherstellung des Upstreams wieder auf true setzen – keine Änderung des Lebenszyklus nötig.
  • source_locale: Sprache des Manifest-Texts (zum Beispiel zh-CN / en-US). Ohne Angabe gilt der Deployment-Standard. Übersetzungen in andere Sprachen werden über diese Quelle gelegt. Hat die neue Quell-Locale bereits eine Übersetzung, enthält die Antwort die Warnung translation-shadowed-by-source, und die Übersetzung wird nicht automatisch gelöscht.
Apps ohne Releases können ebenfalls aktualisiert werden.

Anfrage

Pfadparameter

string
erforderlich
App-Referenz.

Anfrage-Body

enum
Sichtbarkeitsbereich: public / private / shared.Zulässige Werte: public / private / shared.
boolean
Ob neue Runs von anderen akzeptiert werden.
string
Meldung an Caller während der Wartung.
string
Source-Locale-Code des Manifests.

Beispielanfrage

Antwort

200 Erfolg

Payload ist in data gewrappt. Felder:
string
erforderlich
Aktueller Sichtbarkeits-Scope.
boolean
erforderlich
Aktueller Wartungsschalter.
string
Aktuelle Wartungsmeldung.
string
erforderlich
Aktuelle Source-Locale.
object[]
Strukturierte Warnungen.

Fehler

Fehlerantworten nutzen {"error": {code, category, message, retryable}}. Siehe Fehler.

Client-Bibliotheken

Die Python- und JavaScript-SDKs wrappen diesen Endpoint noch nicht. REST direkt aufrufen.