Publishing
Data App umbenennen
App-Name (Routing-Alias) ändern ohne Version-Release und ohne laufende Runs zu betreffen.
POST
Data App umbenennen
POST https://api-datahub.octoparse.com/v1/data-apps/{app_id}/rename
Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>). Nur App-Autor; andere erhalten 404.
Rename ist voll offen — nicht auf Zero-Release-Apps beschränkt. App-Name = Routing-Alias: Rename published keine Version, invalidiert keine alten Versionen und betrifft keine laufenden Runs (alle durable Referenzen pinnen app_id).
Kaputte Caller-Referenzen sind Sache des Developers: alte owner/old-name-Referenzen (MCP-Pins, SDKs, REST, Detail-URLs) liefern nach Rename sauberes 404 ohne Redirect. Historische Runs und Abrechnung zeigen den neuen Namen. Der alte Name ist in Ihrem Namespace nicht von anderen claimbar, aber Sie können ihn später für eine neue App wiederverwenden — residuale externe Referenzen würden dann auf die neue App zeigen. Consumer sollten über app_id integrieren.
Die Validierung entspricht dem Anlegen der Identität: Benennungsregeln → reservierte Wörter → neuer Name ≠ aktueller Name. Ein Konflikt mit der historischen Bindung einer anderen Person ist 409 app-name-reserved; ein Konflikt mit einer anderen Ihrer Apps ist 409 app-name-taken.
Anfrage
Pfadparameter
string
erforderlich
App-Referenz.
Anfrage-Body
string
erforderlich
—
Beispielanfrage
Antwort
200 Erfolg
data gewrappt. Felder:
string
erforderlich
Stabile App-ID — unverändert.
string
erforderlich
Neuer Name.
string
Publisher-Benutzername.
Fehler
Fehlerantworten nutzen
{"error": {code, category, message, retryable}}. Siehe Fehler.