> For the complete documentation index, see [llms.txt](https://trust-positif.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trust-positif.gitbook.io/docs/readme.md).

# Introduction

Cek status **Nawala / Trust Positif** (Kominfo) untuk satu atau banyak domain lewat HTTP API.

## Base URL

```
https://trustpositif.id/api/v1
```

## OpenAPI

Machine-readable spec (import into Postman, RapidAPI, etc.):

* JSON: `https://trustpositif.id/api/openapi.json`
* YAML: `https://trustpositif.id/api/openapi.yaml`

## Quick start

```bash
curl -X POST "https://trustpositif.id/api/v1/check" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tp_your_api_key_here" \
  -d '{"domains": "example.com\ngoogle.com"}'
```

## Endpoints

| Endpoint | Method | Deskripsi                            |
| -------- | ------ | ------------------------------------ |
| `/check` | `POST` | Cek status Nawala untuk 1–100 domain |
| `/limit` | `GET`  | Kuota / limit penggunaan saat ini    |
| `/stats` | `GET`  | Alias dari `/limit`                  |

## Mode akses

1. **Freemium (tanpa API key)** — 100 domain/hari per IP, maks. 60 request/menit.
2. **Freemium (dengan API key)** — limit harian per key (default 100 domain/hari).
3. **Premium (API key + paket aktif)** — kuota bulanan paket; **1 domain = 3 kredit** lewat API.

## Dapatkan API key

1. Daftar / login di [Dashboard](https://trustpositif.id/dashboard).
2. Buka **API Key** → salin key (format `tp_…`).
3. Paket **Business** ke atas termasuk akses API premium — lihat [Paket](https://trustpositif.id/packages).

## Bantuan

* Website: [trustpositif.id](https://trustpositif.id)
* Status layanan: [trustpositif.id/status](https://trustpositif.id/status)
