Synup
Schlüssel erstellen
v1Ressourcen/Connections/getGet what an account can do

Get what an account can do

Says what a connected account can do and, when it cannot, why and what a person has to do. Pass connectionId for one account, clientId for every account of a client, or platform for a network in general. Per operation (publish, edit, delete, read insights and comments, reply, like, hide, delete a comment, private reply, and review reads and replies) it returns allowed and, when not, a reason (unsupported, needs_reconnect, not_connected, suspended or not_offered), a prerequisite and whether a person has to act. Read-only; it never returns credentials.

get/api/v1/connections/capabilities
connections:read
Query-Parameter
connectionIdstringoptional
One account, from the connections list.
clientIdstringoptional
Every account connected for this client.
platformstringoptional
A network's own capabilities, without an account, for example instagram.
limitintegeroptional
Accounts per call when using clientId, 1 to 100.
Antwort
dataobjectoptional
kindstringoptional
accounts, or platform when only a platform was asked about.
accountsarray of objectoptional
For accounts: each with its connection, status and operations.
totalintegeroptional
For accounts: how many accounts there are.
platformstringoptional
For a platform: its key.
operationsobjectoptional
For a platform: the operations, each with allowed and details.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/connections/capabilities
Ihr API-Schlüssel
connectionId
clientId
platform
limit
{
  "data": {
    "kind": "accounts",
    "accounts": [
      {
        "connectionId": "conn_123",
        "platform": "facebook",
        "label": "Facebook",
        "displayName": "Acme Dental",
        "clientId": "cli_123",
        "clientLocationId": null,
        "connectionStatus": "CONNECTED",
        "operations": {
          "publish": {
            "allowed": true,
            "details": {
              "postTypes": [
                "announcement"
              ],
              "captionLimit": 30000,
              "captionRequired": true,
              "mediaRequired": false
            }
          },
          "like_comment": {
            "allowed": true
          },
          "private_reply": {
            "allowed": true,
            "details": {
              "oncePerComment": true,
              "windowDays": 7
            }
          },
          "delete_comment": {
            "allowed": true
          },
          "reply_review": {
            "allowed": true
          }
        }
      }
    ],
    "total": 1
  }
}

Anleitungen, die diese Ressource verwenden