Publishing
設定を更新
可視性・メンテナンス・ソースロケールを切替。いつでも完全に可逆。
PATCH
設定を更新
PATCH https://api-datahub.octoparse.com/v1/data-apps/{app_id}/settings
Authentication: API key required (Authorization: Bearer <API Key>). App author only; others get 404.
App-level, reversible ops state orthogonal to lifecycle — adjustable any time:
scope:publicmarket-visible /privateauthor only /sharedgrant list (maintain the list via the grant endpoints).accepting_runs: maintenance switch.falsemeans under maintenance; new runs from others are rejected (403 app-not-accepting-runs,messagecarriespause_message). Existing runs, purchased data, and market visibility are unaffected; author self-tests are unrestricted. Flip back totrueafter upstream recovery — no lifecycle change required.source_locale: language of the manifest text (for examplezh-CN/en-US). Unset uses the deployment default. Translations for other languages layer on top of this source. If the new source locale already has a translation, the response includes atranslation-shadowed-by-sourcewarning and does not auto-delete it.
Request
Path parameters
string
必須
App reference.
Request body
enum
Visibility scope:
public / private / shared.Allowed values: public / private / shared.boolean
Whether to accept new runs from others.
string
Message shown to callers while under maintenance.
string
Source locale code of the manifest.
Example request
Response
200 success
data. Fields:
string
必須
Current visibility scope.
boolean
必須
Current maintenance switch.
string
Current maintenance message.
string
必須
Current source locale.
object[]
Structured warnings.
Errors
Error responses use
{"error": {code, category, message, retryable}}. See Errors.