> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Autentikasi API

> GOWA mengautentikasi panggilan API hanya dengan HTTP Basic Auth.

GOWA hanya mendukung **HTTP Basic Auth**: REST API tidak menggunakan API key, bearer token, atau JWT. (MCP juga dapat menerima token OAuth; lihat [Server MCP](https://gowa-docs.mintlify.site/id/integrations/mcp.md#klien-jarak-jauh-dengan-oauth).)

## Konfigurasi

```bash theme={null}
APP_BASIC_AUTH=admin:changeme,ops:another-password   # or --basic-auth=admin:changeme
```

Setiap pasangan `user:pass` yang dipisahkan koma merupakan kredensial login yang valid. Setiap entri harus berisi nama pengguna dan kata sandi. Listener pada alamat non-loopback tidak akan dijalankan tanpa kredensial lengkap. Gunakan `APP_HOST=127.0.0.1` untuk pengembangan lokal tanpa autentikasi. Gunakan `APP_ALLOW_UNAUTHENTICATED=true` hanya jika reverse proxy mengautentikasi pemanggil dan akses langsung ke GOWA dibatasi.

## Mengirim kredensial

```bash curl theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```bash Header theme={null}
curl -H "Authorization: Basic $(echo -n 'admin:changeme' | base64)" \
  -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```javascript JavaScript theme={null}
const res = await fetch("http://localhost:3000/user/my/groups", {
  headers: {
    Authorization: "Basic " + Buffer.from("admin:changeme").toString("base64"),
    "X-Device-Id": "my-device",
  },
});
```

```python Python theme={null}
import requests
r = requests.get("http://localhost:3000/user/my/groups",
                 auth=("admin", "changeme"),
                 headers={"X-Device-Id": "my-device"})
```

Kredensial yang salah atau tidak disertakan menghasilkan `401 Unauthorized`.

## Rute publik

| Rute | Alasan |
| - | - |
| `/health` | Pemeriksaan apakah layanan aktif. |
| `/statics/*` | Gambar QR dan file media. URL yang diketahui tetap dapat diakses publik. Unggahan selain gambar diunduh sebagai lampiran. Lindungi akses melalui proxy Anda jika diperlukan. |
| `/chatwoot/webhook`, `/chatwoot/webhook/{device_id}` | Dipanggil oleh Chatwoot; dilindungi dengan `CHATWOOT_WEBHOOK_SECRET`. |
| Endpoint OAuth MCP dan metadata `/.well-known/*` | Alur OAuth, jika diaktifkan. |

## WebSocket

Browser tidak dapat mengatur header pada koneksi WebSocket, sehingga `/ws` juga menerima `/ws?device_id=my-device&authorization=<base64 user:pass>`. Gunakan `wss://` dan samarkan kredensial dalam log proxy.

WebSocket dan rute HTTP yang mengubah status menolak origin browser yang tidak tepercaya. Tetapkan origin dasbor secara persis di `APP_TRUSTED_ORIGINS` atau `APP_CORS_ALLOWED_ORIGINS`. Origin CORS wildcard tidak memberikan akses ini, dan origin `null` dari halaman `file://` ditolak. Perubahan melalui HTTP dari origin yang tidak tepercaya menghasilkan `403 CROSS_SITE_REQUEST_BLOCKED`. Lihat [konfigurasi akses browser](https://gowa-docs.mintlify.site/id/authentication.md#cors).

## Header perangkat

Basic Auth mengidentifikasi pemanggil API, bukan akun WhatsApp. Setiap panggilan yang terikat pada perangkat juga memerlukan `X-Device-Id` jika terdapat lebih dari satu perangkat. Lihat [Multiperangkat](https://gowa-docs.mintlify.site/id/concepts/multidevice.md).

> [!WARNING]
>
> Basic Auth mengirimkan kredensial pada setiap permintaan. Selalu gunakan HTTPS di depan GOWA jika diakses dari luar jaringan tepercaya.


## Related topics

- [Autentikasi](https://gowa-docs.mintlify.site/id/authentication.md)
- [Referensi API](https://gowa-docs.mintlify.site/id/api-reference/introduction.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Mulai Cepat](https://gowa-docs.mintlify.site/id/quickstart.md)
- [Metrik server](https://gowa-docs.mintlify.site/id/api-reference/metrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.