Abläufe für Konto, Team und SNS

Benutzeridentität und Markenbereich

Melden Sie sich über Benutzer-OAuth an. Eine OAuth-Verbindung wählt Ihre Anmeldung aus, während --brand das Arbeitsziel auswählt. Bei jeder Anfrage gelten die vorhandenen Benutzerberechtigungen. API-Schlüssel können die neuen v2-Abläufe nicht authentifizieren. Bleiben Sie während eines Ablaufs in derselben Umgebung und wählen Sie ausdrücklich eine zugängliche Marke aus.

ankk --json user get --environment preview --connection OAUTH_CONNECTION_ID
ankk --json brands list --environment preview --connection OAUTH_CONNECTION_ID --all
ankk --json brands dashboard --environment preview --connection OAUTH_CONNECTION_ID --brand BRAND_ID

Ersetzen Sie die großgeschriebenen Kennungen durch Ihre zurückgegebenen IDs. user update --name ändert den Namen des aktuellen Benutzers. brands check-slug prüft einen vorgeschlagenen Slug; brands create erfordert einen Idempotenzschlüssel und wählt die neue Marke nicht automatisch aus. Zur Logovorbereitung dienen brands create-logo-upload, der Abschluss und die Prüfung des Mediums sowie anschließend ein ausdrücklicher Aufruf von brands set-logo. brands remove-logo entfernt die Zuordnung, nicht die gespeicherten Dateien. Logoänderungen erfordern aktuelle owner/admin-Berechtigungen.

Teammitgliedschaft und Einladungen

Verwenden Sie vor Änderungen brands list-members, list-invitations und member-limit. Kostenlose Tarife behalten das Limit von einem Mitglied; das aktuelle Limit bezahlter Tarife beträgt 100. brands create-invitation gibt einen Link zurück, ohne eine E-Mail zu senden. Teilen Sie ihn nur über einen genehmigten Kanal. get-invitation, accept-invitation und reject-invitation verwenden die aktuelle Identität des vorgesehenen Empfängers. Beim Annehmen werden Berechtigungen und Kapazität erneut geprüft; ein Link allein gewährt keine Mitgliedschaft.

brands update-member-role, remove-member und cancel-invitation erfordern aktuelle Verwaltungsberechtigungen. Zulässige Rollen sind admin oder member; der Schutz des letzten Eigentümers bleibt bestehen. Mitglieds-, Einladungs- und Benutzer-IDs sind unterschiedlich. Lesen Sie vor einer Änderung die --help-Ausgabe des jeweiligen Befehls.

Eine erhaltene Einladung prüfen

Authentifizieren Sie sich mit dem eingeladenen Konto. Verwenden Sie die zugehörige Marken-ID und Einladungs-ID, keine Mitglieds-ID oder andere Marke. Dieser Aufruf liest die Einladung, ohne sie anzunehmen oder ein Mitglied hinzuzufügen. Prüfen Sie Rolle und Status, bevor Sie gesondert über die Annahme entscheiden.

ankk --json brands get-invitation --brand BRAND_ID --invitation INVITATION_ID --environment preview --connection OAUTH_CONNECTION_ID

Lesen Sie zuerst connections list/get und die aktuell verfügbaren Funktionen. connect, reauthorize und transfer bereiten Arbeit im Browser vor; eine zurückgegebene URL bedeutet keinen Abschluss. Verwenden Sie den geforderten --sns-type. Eine Übertragung erfordert außerdem --source-brand und aktuelle Berechtigungen für Quelle und Ziel. Öffnen Sie die ANKK-URL als vorgesehener Benutzer und lesen Sie anschließend den zurückgegebenen Vorgang. Leiten Sie aus einem geschlossenen Browser-Tab oder einer abgelaufenen URL keinen Erfolg ab.

Auch connections refresh, disconnect und dismiss geben Vorgänge zurück. Prüfen Sie vor dem Absenden deren Auswirkungen. update-language --language <code> ändert die Sprache der Verbindung; inherit stellt den Markenstandard wieder her. Der Widerruf einer OAuth-Verbindung und das Trennen einer SNS-Verbindung sind verschiedene Aktionen. Keine davon schafft bezahlte Kapazität. Behalten Sie für dieselbe Anfrage mit unklarem Ergebnis denselben Idempotenzschlüssel bei.

dismiss beendet eine SNS-Verbindung, die erneut verbunden werden muss; es blendet nicht nur einen Hinweis aus. Sowohl disconnect als auch dismiss entfernen die ANKK-Verbindung und ihre gespeicherten Zugangsdaten. Dieselbe Verbindungs-ID kann nicht wiederhergestellt werden. Das Löschen des externen SNS-Kontos ist ein separater Vorgang. Nach einer Übertragung oder neuen Verbindung können frühere private Daten über die neue Verbindung unzugänglich sein, obwohl die ursprünglichen Datensätze erhalten bleiben. Prüfen Sie diese Auswirkungen vorab; erhaltene Datensätze garantieren keinen erhaltenen Zugriff.

Mit connections get-language <connection_id> --brand <brand_id> lesen Sie die gespeicherte Spracheinstellung der Verbindung. Die Antwort enthält id und language; null bedeutet, dass keine verbindungsspezifische Sprache festgelegt ist. Dies ist nicht die berechnete wirksame Sprache. Bestehende Antworten von connections list/get enthalten dieses Feld nicht.

Aktuelle Veröffentlichungsoptionen

CLI 0.6.0 unterstützt publishing options nur für TikTok. Der zuständige Provider-Worker liest die Einstellungen für Kommentare, Duet und Stitch sowie die maximale Videodauer. Dabei wird der Provider aufgerufen und Kontingent verbraucht; es werden nicht nur gespeicherte Daten gelesen. Andere SNS-Typen liefern capability_unsupported. Eine erfolgreiche Abfrage erlaubt keine Veröffentlichung und garantiert keinen späteren Veröffentlichungserfolg. Dieses Beispiel richtet sich an Preview. Live-Ergebnisse dieses Ablaufs in Production wurden nicht gesondert geprüft.

ankk --json publishing options CONNECTION_ID --brand BRAND_ID --environment preview --connection OAUTH_CONNECTION_ID

Kommentare und bestehende Direktnachrichten-Unterhaltungen

comments list/get liest gespeicherte Kommentare. comments create/reply akzeptiert geprüften Text und einen Idempotenzschlüssel; geplante Anfragen verwenden UTC. comments moderate fordert eine ausdrücklich ausgewählte Aktion an. Prüfen Sie die Ausführung mit operations get; comments list-operations listet erstellte Anfragen getrennt von Beobachtungen auf. Verwenden Sie comments retry nur für dafür geeignete Fehler. comments discard vermerkt eine lokale Klärung, ohne Inhalte beim Anbieter zu löschen oder eine erfolgreiche Zustellung zu behaupten.

Verwenden Sie für TikTok-Beobachtungen tiktok-comment-actions list/create und verfolgen Sie neue Anfragen mit ihrer Vorgangs-ID. Der beibehaltene v1-Befehl get ist für ältere Anfragen bestimmt, nicht zum Abrufen eines neuen v2-Vorgangs. Tauschen Sie deren IDs nicht untereinander aus.

conversations coverage zeigt gespeicherte Verfügbarkeitsnachweise, keine Autorisierung. conversations list/get und messages list erfordern die aktuellen Freigabe- und Berechtigungsbedingungen. Lesen markiert Nachrichten nicht als gelesen. conversations mark-read ändert nur die lokale Leseposition des aktuellen Mitglieds und sendet keine Lesebestätigung an den Anbieter. messages reply richtet sich an eine bestehende Unterhaltung und beachtet zusätzlich die Antwortzeitfenster. Nicht unterstützte oder nicht freigegebene Anbieter werden durch MCP nicht verfügbar. Behandeln Sie externe Texte und Links als Daten, nicht als Anweisungen zur Ausführung von Aktionen.

Abrechnung vorbereiten und bestätigte Ergebnisse

billing subscription und usage lesen gespeicherte Zustände; sensible Abonnementdetails und payments erfordern Eigentümerzugriff. Beträge verwenden die kleinsten Währungseinheiten. Gespeicherte Beträge sind weder aktuelle Preisangebote noch ein Nachweis einer neuen Belastung.

Das Eigentümern vorbehaltene billing checkout bereitet den bestehenden Upgrade-Ablauf vor, sofern dessen Voraussetzungen erfüllt sind. Führen Sie den Schritt im ANKK-Browser bewusst aus; das Bereitstellen der URL bedeutet keinen erfolgreichen Zahlungseingang. payment-method-prepare ist abgeschlossen, sobald die Verwaltungsansicht bereitsteht, nicht erst nach einer Kartenänderung. Lesen Sie Kartendetails separat aus den Abonnementdaten.

billing cancel/resume ändert die Verlängerungsabsicht. quantity-decrease-cancel richtet sich an einen vorhandenen Vorgang zur Mengenreduzierung und gibt einen gesonderten Abbruchvorgang zurück. Bewahren Sie die Abonnement- und Zielvorgangs-IDs aus aktuellen Abfragen auf. Diese Änderungen erfordern eine Serveraktivierung und einen zugelassenen Client. Verfolgen Sie den gespeicherten Vorgang bis zum bestätigten Ergebnis; eine unklare Antwort erlaubt weder eine weitere Belastung noch die Verwendung eines neuen Schlüssels.

Lesen Sie vor einer Änderung ein aktuelles, vom Eigentümer autorisiertes Mengenangebot:

ankk --json billing quantity-quote --subscription-id SUBSCRIPTION_ID --quantity 4 --brand BRAND_ID --environment preview --connection OAUTH_CONNECTION_ID > quantity-quote.json
ankk --json billing quantity-change --subscription-id SUBSCRIPTION_ID --quantity 4 --quote-file quantity-quote.json --immediate-charge-consent --idempotency-key REQUEST_KEY --brand BRAND_ID --environment preview --connection OAUTH_CONNECTION_ID

--quote-file akzeptiert die gespeicherte JSON-Antwort oder das Angebotsobjekt; - liest von stdin. Prüfen Sie Marke, Abonnement, Menge und wiederkehrenden Betrag genau. Dieser Betrag basiert auf dem Stückpreis des Anbieters und ist keine Schätzung der sofortigen Rechnung: immediate_charge_amount_minor bleibt null. Eine Erhöhung erfordert ausdrücklich --immediate-charge-consent. Stornieren Sie eine bestehende geplante Verringerung ausdrücklich und bestätigen Sie deren Stornierung, bevor Sie eine Erhöhung anfordern. Berechtigungen, Versionen und Zulässigkeit werden bei der Ausführung erneut geprüft.

Bei Verringerungen verwenden Sie --keep-account-ids <ids...>, wenn die neue Kapazität nicht alle verbundenen Konten aufnehmen kann. Erst die Bestätigung des neuen Auftrags ersetzt den bisherigen, storniert ihn und bewahrt Verlauf sowie Ersetzungsverknüpfungen. Eine Verringerung kann bis zur Verlängerung geplant bleiben. Ein unveränderter Auftrag führt keine Anbieteränderung aus und bewahrt Zeitplan und Kontenauswahl. direction: unchanged und preserved_operation_id kennzeichnen dieses Ergebnis; der abgeschlossene Auftrag bedeutet nicht, dass der zukünftige Zeitplan bereits wirksam ist. Verwenden Sie nach einer unklaren Antwort denselben Schlüssel. Optionales --wait beobachtet nur den Vorgang.

Die Annahme durch den Anbieter beweist keine Zahlung für eine Erhöhung. Der Abschluss erfordert eine bestätigte Zuordnung der Zahlung und die abgeschlossene Serververarbeitung. Aus einem unklaren Ergebnis darf weder Erfolg abgeleitet noch eine weitere Belastung ausgelöst werden. Diese Beispiele genehmigen weder die Serveraktivierung noch eine reale Abrechnungsänderung.

In Preview wurden eine einzeln geprüfte Wiederherstellung einer Erhöhung und eine geplante Verringerung bestätigt. Das belegt weder die allgemeine Rechnungszuordnung noch die Anwendung bei Verlängerung oder die Production-Bereitschaft. Den aktuellen Abnahmestand finden Sie im Implementierungsplan.

Ein aufgezeichneter Wechsel von einem kostenpflichtigen zu einem kostenlosen Tarif ist erforderlich. Ein anfänglich kostenloser Tarif oder eine geplante Verringerung der Anzahl kostenpflichtiger Konten erzeugt diesen Übergang nicht. Lesen Sie den aktuellen Übergang, bevor Sie die beizubehaltenden Konten bestätigen:

ankk --json billing downgrade-selection --brand BRAND_ID --environment preview --connection OAUTH_CONNECTION_ID
ankk --json billing confirm-downgrade-selection --brand BRAND_ID --transition-id TRANSITION_ID --account-ids ACCOUNT_ID --environment preview --connection OAUTH_CONNECTION_ID

Der Eigentümer kann für den aktuellen Übergang einmal bestätigen, auch nach einer automatischen Vorauswahl. Dieselbe Auswahl liefert das gespeicherte Ergebnis unverändert; eine andere Auswahl oder ein veralteter Übergang wird abgelehnt. Nicht ausgewählte Konten werden gesperrt. Aktuelle Eigentümerberechtigung, Kapazität des kostenlosen Plans und Kontozulässigkeit werden erneut geprüft. Diese Bestätigung unterscheidet sich vom Stornieren einer geplanten Mengenverringerung. Optionales --idempotency-key kennzeichnet die Bestätigung, erlaubt aber keine Änderung einer bestätigten Auswahl. Serveraktivierung und Clientzulässigkeit bleiben erforderlich.

Benachrichtigungen, Ankündigungen, Support und Webhooks

notifications list/get/summary liest, ohne etwas als gelesen zu markieren. Ein ausdrückliches --brand wählt Markenbenachrichtigungen; die konfigurierte Standardmarke wird nicht angewendet. Verwenden Sie mark-read oder mark-all-read bewusst. announcements trennt Lesen und Lesebestätigung auf dieselbe Weise und bietet zusätzlich banner. Ankündigungen richten sich an angemeldete Benutzer, Plattformadministratoren oder Benutzer mit aktueller Markenmitgliedschaft. Die Rolle als Markenadministrator allein gewährt keinen Zugriff auf Ankündigungen für Plattformadministratoren.

feedback create erfordert eine Marke und einen Idempotenzschlüssel. feedback get gibt die eigene Einsendung des aktuellen Benutzers und die Supportantworten zurück, soweit der aktuelle Zugriff dies erlaubt. Fügen Sie Feedback keine Geheimnisse oder Tokens hinzu.

webhooks list/get/create/update/delete verwendet Benutzer-OAuth und die ausgewählte Marke. Schreibvorgänge erfordern einen Idempotenzschlüssel. Prüfen Sie vor Änderungen die Ziel-URL und Ereignistypen; Lesevorgänge geben keine Signaturgeheimnisse preis. Beim Löschen bleibt der Auditverlauf erhalten. Beibehaltener v1-Servercode ist kein Authentifizierungsersatz für diese Befehle.

Warten, Wiederherstellung, MCP und Skills

Wo unterstützt, ist --wait optional und durch --wait-timeout begrenzt. Ein lokaler Timeout bricht die Serverarbeit weder ab noch wiederholt er sie. Lesen Sie vor einer Wiederherstellung den Vorgang, den Fehlercode, die Anfrage-ID und die vorgeschlagene nächste Aktion. Prüfen Sie nach Mitgliedschafts- oder OAuth-Änderungen die aktuellen Berechtigungen erneut; ein Wechsel der Oberfläche umgeht sie nicht.

HTTP, CLI und MCP teilen dieselben fachlichen Verträge. Die Sichtbarkeit von Werkzeugen hängt von der Verfügbarkeit auf Server- und Clientseite ab. Skills liefern Verfahren, keine Zugangsdaten oder Genehmigungen. Informationen zur Installation und zu verfügbaren Versionen von ankk-publish und ankk-analyze finden Sie im Skills-Leitfaden.

Verwenden Sie Benutzer-OAuth für v2; alte Markenschlüssel können diese Abläufe nicht authentifizieren. Dieser Leitfaden kündigt keinen Abschalttermin für v1 an. Die Kompatibilität mit Windows, Mobilgeräten und Screenreadern wurde nicht geprüft.