Einen Verbindungslink abrufen

Erstellt eine kurzlebige URL, die eine soziale Plattform mit einer Marke verbindet. Sie kommen nie mit den OAuth-Zugangsdaten der Plattform in Berührung: Leiten Sie Ihren Endnutzer zur zurückgegebenen url weiter; dort durchläuft er den Zustimmungsdialog der Plattform und wählt die Seite, Pinnwand oder Organisation aus, auf der veröffentlicht werden soll, und wird anschließend zu Ihrer redirectUrl zurückgeleitet.

Dies ist die einzige Social-Schreiboperation mit einem flachen Body. Jede andere Schreiboperation in der Social API ist in ein input-Objekt eingebettet; diese nicht. Senden Sie channel, redirectUrl und optional errorUrl und state auf der obersten Ebene.

Anwendungsfall: eigenständiges Verbinden von Kanälen innerhalb Ihres Produkts. Zeigen Sie dem Nutzer die fünf Plattformen an und rufen Sie nach seiner Auswahl diesen Endpunkt mit dem entsprechenden channel und einem state auf, der seine Sitzung identifiziert. Leiten Sie ihn zu url weiter. Wenn er mit status=success zu Ihrer redirectUrl zurückkehrt, fragen Sie GET /social/brands/{brandId}/connections wiederholt ab, bis der neue Kanal erscheint, und lassen Sie ihn dann mit POST /social/posts seinen ersten Beitrag verfassen.

Wohin der Nutzer zurückgeleitet wird

Wenn der Ablauf endet, wird der Nutzer mit angehängten Abfrageparametern zu Ihrer redirectUrl (oder errorUrl) weitergeleitet:

https://app.example.com/social/connected  ?status=success  &brandId=6f2c9a41-7b0e-4d55-9a2f-3c8e1d47b902  &platform=INSTAGRAM  &state=sess_9f2c1e64  &connectedAccountId=b81d5b3c-4a90-4f6a-9c11-71e0dd2fa4a7

Hinweise.

• Der Link läuft ab. expiresIn enthält seine Gültigkeitsdauer in Sekunden. Er ist nur einmal verwendbar: Erstellen Sie ihn in dem Moment, in dem der Nutzer auf „Verbinden“ klickt, nicht im Voraus, und speichern Sie ihn niemals. Wenn der Nutzer den Ablauf abbricht, rufen Sie diesen Endpunkt erneut auf, um eine neue URL zu erhalten.
• Die Verbindung wird asynchron angelegt. Der Nutzer kehrt einen Moment, bevor der Verbindungseintrag existiert, zu Ihrer redirectUrl zurück, daher kann eine unmittelbar nach der Rückkehr abgerufene Verbindungsliste durchaus noch ohne diesen Eintrag zurückkommen. Fragen Sie die Verbindungsliste einige Sekunden lang wiederholt ab, statt den ersten leeren Abruf als Fehler zu behandeln.
• Instagram benötigt ein Business- oder Creator-Konto, das mit einer Facebook-Seite verknüpft ist. Ein persönliches Instagram-Konto kann nicht verbunden werden und wird im Zustimmungsdialog der Plattform nicht angeboten. Wenn Ihre Nutzer auf dieses Problem stoßen, bitten Sie sie, das Konto in der Instagram-App umzustellen und mit der von ihnen verwalteten Seite zu verknüpfen, und erstellen Sie anschließend den Link erneut.
• TWITTER ist X. Der Enum-Wert ist aus Gründen der Abwärtskompatibilität TWITTER geblieben; das Produkt heißt X. Plattformwerte sind Enum-Namen in Großbuchstaben — das Senden von "instagram" wird abgelehnt.
• redirectUrl und errorUrl müssen absolute https-URLs sein. Eine relative URL oder eine http-URL wird mit SY95049 abgelehnt.
• Verbindungen sind die nach Verbrauch abgerechnete Ressource. Jede Verknüpfung beansprucht einen Platz aus einem gemeinsamen Kontingent für das gesamte Konto — 20 Verbindungen bei Social Launch, 125 bei Social Growth, dazu fünf für jedes Verbindungspaket für 25 $ pro Monat, bis zu einer im Self-Service verfügbaren Obergrenze von 250. Die Anzahl der Marken selbst ist unbegrenzt, daher ist es immer dieser Aufruf und niemals das Erstellen einer Marke, bei dem die Kapazität erschöpft ist. Wenn das Kontingent ausgeschöpft ist, wird für den Link status: "failed" mit SY95042 zurückgegeben. Siehe Tarife und Zusatzpakete und entnehmen Sie Ihre verbleibende Kapazität GET /social/limits.
• Dies ist die Social-Entsprechung des Facebook-Verbindungslinks auf Standortebene, aber die beiden sind separate Produkte, und Verbindungen, die in einem Produkt hergestellt werden, sind im anderen nicht sichtbar.

Schreiboperation: nicht im Live-Konto ausgeführt. Die gezeigte Anfrage und Antwort werden aus dem API-Schema erstellt.