Ir para o conteúdo

GetInstances#

Este método destina-se a obter todas as instâncias de contas criadas por um parceiro.

Requisição#

Para obter todas as instâncias de conta, é necessário fazer uma solicitação GET para o seguinte URL:

https://api.green-api.com/partner/getInstances/{partnerToken}

A obtenção do parâmetro de solicitação partnerToken é feita através do suporte da Green API (suporte@green-api.com.br) com uma solicitação para obter a chave de API do parceiro.

Resposta#

Campos da resposta#

Campo Tipo Descrição
idInstance int identificador da instância da conta
apiTokenInstance string token da API da instância da conta
typeInstance string tipo de mensageiro para a instância da conta
timeCreated string hora de criação da instância

Exemplo de corpo de resposta#

Em caso de sucesso, em resposta à solicitação, é fornecida uma string JSON no seguinte formato com o status HTTP 200:

[
    {
        "idInstance": 1101728004,
        "name": "Instance 1101728004",
        "typeInstance": "whatsapp",
        "typeAccount": "",
        "partnerUserUiid": "",
        "timeCreated": "2022-06-03T18:39:44",
        "timeDeleted": "0001-01-01T00:00:00",
        "apiTokenInstance": "1f2485e80f474293b935f77d78c64e76fa4bdceb417a4998a4",
        "deleted": false,
        "tariff": "PARTNER_23",
        "expirationDate": "2022-06-09T18:39:44",
        "isExpired": false
    },
    {
        "idInstance": 1101728204,
        "name": "Instance 1101728204",
        "typeInstance": "whatsapp",
        "typeAccount": "",
        "partnerUserUiid": "",
        "timeCreated": "2022-06-07T10:36:48",
        "timeDeleted": "2022-06-07T10:37:00",
        "apiTokenInstance": "35d8b4907f8e494289b1d5f999e3582940ceffc413bf4a76b1",
        "deleted": true,
        "tariff": "PARTNER_23",
        "expirationDate": "2022-06-08T10:36:48",
        "isExpired": false
    },
    {
        "idInstance": 1101728478,
        "name": "Instance 1101728478",
        "typeInstance": "whatsapp",
        "typeAccount": "",
        "partnerUserUiid": "",
        "timeCreated": "2022-06-08T09:12:13",
        "timeDeleted": "2022-06-08T09:19:04",
        "apiTokenInstance": "c8b0474542154e0ead529eb3861ca5f483c346eb00564f64a7",
        "deleted": true,
        "tariff": "PARTNER_23",
        "expirationDate": "2022-06-09T09:12:13",
        "isExpired": false
    }
]

Para obter os parâmetros das instâncias das contas, são utilizados os métodos API correspondentes.

Em caso de falha, é retornado uma resposta com o status HTTP 400 e o texto do erro.