Sua primeira requisição

Consulte os dados da conta com GET /accounts/me em cURL, JavaScript, Python ou PHP, entenda a resposta e saiba o que fazer com o erro 401.

Guia5 min

Atualizado em 26/10/2026

A primeira chamada é a mais simples da API: Consultar a conta, GET /accounts/me. Ela só lê os dados da conta e não muda nada, por isso serve para conferir a chave e o seu ambiente antes de qualquer integração.

Antes de começar

A chave de API na variável de ambiente NEXTAGS_API_KEY. Veja Autenticação com a chave de API.
Uma destas opções: cURL; Node 18 ou mais novo (o fetch já vem pronto); Python 3 com requests (pip install requests); ou PHP com a extensão cURL.

Passo a passo

Passo 1: Faça a chamada

O endereço é a URL base da API, https://app.nextagsai.com.br/api, mais o caminho /accounts/me. Rode o exemplo da sua linguagem no servidor ou no seu computador, nunca no navegador nem num app de celular, onde a chave ficaria à mostra.

Consultar a conta

curl "https://app.nextagsai.com.br/api/accounts/me" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY"

const resposta = await fetch('https://app.nextagsai.com.br/api/accounts/me', {
  headers: {
    'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
  },
});
const dados = await resposta.json();
console.log(resposta.status, dados);

import os

import requests

resposta = requests.get(
    "https://app.nextagsai.com.br/api/accounts/me",
    headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
    timeout=30,
)
print(resposta.status_code, resposta.json())

<?php
$ch = curl_init('https://app.nextagsai.com.br/api/accounts/me');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
    ],
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);

Em JavaScript, salve o código como primeira.mjs e rode node primeira.mjs: o await fora de uma função só funciona em arquivo .mjs. Em Python e em PHP, rode o arquivo como de costume (python primeira.py, php primeira.php).

Passo 2: Leia a resposta

Com a chave certa, a resposta é 200, com os dados da conta:

{
  "page_id": 123456,
  "name": "Doce Encanto",
  "active": true,
  "created": 1768478400,
  "total_users": 4210
}

Campo	O que é
`page_id`	O ID da conta.
`name`	O nome da conta.
`active`	`false` quando os administradores não conseguem entrar no painel da conta.
`created`	Quando a conta foi criada, em Unix timestamp. O contrato não diz se em segundos ou em milissegundos: confira no seu teste.
`total_users`	O total de contatos da conta.

Passo 3: Se vier 401, confira a chave

Se a resposta for 401, a chave não veio, está incompleta ou foi excluída. O corpo é sempre este:

{"error": {"code": 401, "message": "No valid API key provided."}}

O cabeçalho Content-Type desse erro vem text/html, mas o corpo é JSON: os exemplos acima leem o corpo do mesmo jeito. Confira a variável NEXTAGS_API_KEY e veja Autenticação com a chave de API.

Pronto: como conferir

A resposta é 200, e o name é o nome da sua conta, o mesmo que aparece no painel da NexTags.
Agora é só escolher o próximo passo: Criar ou atualizar um contato, Enviar um fluxo para um contato ou a Referência da API.

Se não funcionou

401 com "No valid API key provided."

A chave está errada ou não chegou à chamada. Copie a chave inteira, sem espaços, e confira o nome do cabeçalho: X-ACCESS-TOKEN. Se a chave foi excluída e gerada de novo, use a nova.

A chave chega vazia

A variável NEXTAGS_API_KEY não existe no processo que roda o código: o JavaScript manda undefined, o Python para com KeyError e o PHP manda a chave vazia. Defina a variável no mesmo terminal ou serviço que roda o código. Veja Autenticação com a chave de API.

JavaScript: erro no await ou "fetch is not defined"

O await fora de uma função pede um arquivo .mjs (ou "type": "module" no package.json). O fetch pronto pede o Node 18 ou mais novo: confira com node --version.

Python: "No module named 'requests'"

Instale a biblioteca com pip install requests e rode de novo.

PHP: "Call to undefined function curl_init()"

A extensão cURL do PHP está desligada. Instale ou ative a extensão (no Linux, o pacote costuma se chamar php-curl) e rode de novo.

A chamada fica parada

O servidor não alcança app.nextagsai.com.br pela porta 443. Confira a internet e o firewall. Ponha sempre um tempo limite nas chamadas, como o timeout=30 do exemplo em Python.

Faça com a IA

Copie o pedido e cole no ChatGPT ou no Claude.

Leia https://docs.nextags.com.br/comecar/primeira-requisicao.md.

Escreva, em [linguagem], um script que chama GET /accounts/me na API da NexTags com a chave da variável de ambiente NEXTAGS_API_KEY e mostra o nome da conta e o total de contatos. Se a resposta for 401, mostre uma mensagem dizendo que a chave está errada. Não peça a minha chave.

Obrigado! Sua resposta ajuda a melhorar a central.