Synup
Créer une clé
v1Ressources/Connexions/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
Paramètres de requête
connectionIdstringfacultatif
One account, from the connections list.
clientIdstringfacultatif
Every account connected for this client.
platformstringfacultatif
A network's own capabilities, without an account, for example instagram.
limitintegerfacultatif
Accounts per call when using clientId, 1 to 100.
Réponse
dataobjectfacultatif
kindstringfacultatif
accounts, or platform when only a platform was asked about.
accountsarray of objectfacultatif
For accounts: each with its connection, status and operations.
totalintegerfacultatif
For accounts: how many accounts there are.
platformstringfacultatif
For a platform: its key.
operationsobjectfacultatif
For a platform: the operations, each with allowed and details.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/connections/capabilities
Votre clé API
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
  }
}

Guides qui utilisent cette ressource