# 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.

Endereço: https://docs.nextags.com.br/comecar/primeira-requisicao/
Tipo: Guia

Atualizado em: 26/10/2026

A primeira chamada é a mais simples da API: [Consultar a conta](https://docs.nextags.com.br/referencia/conta/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](https://docs.nextags.com.br/comecar/autenticacao/).
- 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**

```bash
curl "https://app.nextagsai.com.br/api/accounts/me" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY"
```
```javascript
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);
```
```python
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
<?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:

```json
{
  "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:

```json
{"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](https://docs.nextags.com.br/comecar/autenticacao/).

## 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](https://docs.nextags.com.br/guias/criar-ou-atualizar-contato/), [Enviar um fluxo para um contato](https://docs.nextags.com.br/guias/enviar-fluxo/) ou a [Referência da API](https://docs.nextags.com.br/referencia/).

## 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](https://docs.nextags.com.br/comecar/autenticacao/).

### 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

Cole este pedido no ChatGPT ou no Claude:

```text
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.
```