# API Overview — geonet-console

> **Base URL:** `https://console.gisportal.id/api/v1`
> **Internal:** `http://127.0.0.1:8091/api/v1`
> **Terakhir Diperbarui:** 2026-06-29

---

## Auth

Semua endpoint (kecuali `/auth/login`, `/auth/refresh`, `/auth/token-guide`) memerlukan header:

```
Authorization: Bearer <token>
```

Token bisa berupa:
- **JWT** — dari `POST /auth/login`
- **API Token** — personal access token
- **Service Token** — token antar-service

---

## Format Response Standard

**Success:**
```json
{"data": {...}, "message": "success"}
```

**Success list:**
```json
{"data": [...], "meta": {"total": 42, "page": 1}}
```

**Error:**
```json
{"message": "Pesan error", "errors": {"field": ["Validasi"]}}
```

---

## Endpoints Ringkas

| Service | Endpoint Utama | Scope |
|---------|---------------|-------|
| Auth | `POST /auth/login` | Public |
| Me | `GET /me` | — |
| LDAP Users | `GET /ldap/users` | `ldap:read` |
| LDAP Groups | `GET /ldap/groups` | `ldap:read` |
| Databases | `GET /databases` | `databases:read` |
| Service Tokens | `GET /service-tokens` | — |
| Project Search | `POST /project-search/ask` | `project-search:read` |

---

## Rate Limiting

| Endpoint | Limit |
|----------|-------|
| `/auth/login` | 5 req/menit |
| General | 60 req/menit |

---

## Docs Detail

| File | Isi |
|------|-----|
| `service-auth.md` | Login, refresh, token guide, `/me` |
| `service-ldap.md` | LDAP users & groups |
| `service-database.md` | Database registry |
| `service-tokens.md` | Service token CRUD |
| `service-project-search.md` | AI project search |
| `error-codes.md` | Error format & codes |

> Dokumentasi lengkap juga di `geonet-console/docapi/` (lebih detail, per-endpoint).