v1Recursos/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
Parâmetros de consulta
connectionIdstringopcional
One account, from the connections list.
clientIdstringopcional
Every account connected for this client.
platformstringopcional
A network's own capabilities, without an account, for example instagram.
limitintegeropcional
Accounts per call when using clientId, 1 to 100.
Resposta
dataobjectopcional
kindstringopcional
accounts, or platform when only a platform was asked about.
accountsarray of objectopcional
For accounts: each with its connection, status and operations.
totalintegeropcional
For accounts: how many accounts there are.
platformstringopcional
For a platform: its key.
operationsobjectopcional
For a platform: the operations, each with allowed and details.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/connections/capabilities
Sua chave de 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
  }
}

Guias que usam este recurso