API Reference — Gateway

Endpoint untuk mengelola IP Whitelist, Whitelist Resource, dan menelusuri Log History request API Gateway.

← Kembali ke Gateway

Panduan operator: tambah, edit, hapus IP whitelist, dan menelusuri Log History.

Otentikasi

Cara memperoleh dan menggunakan Bearer token JWT.

Semua endpoint memerlukan header Authorization: Bearer <token>. Basis URL mengikuti variabel lingkungan VITE_API_URL yang dikonfigurasi pada instalasi Lenz. Jika Anda belum punya token, lihat halaman Otentikasi.

Whitelist Resource

Whitelist Resource adalah definisi endpoint atau kelompok endpoint yang dilindungi oleh API Gateway. Setiap entri IP Whitelist harus merujuk ke salah satu resource yang terdaftar.

Daftar Whitelist Resource

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

page?integer

Nomor halaman, dimulai dari 1.

Default1

page_size?integer

Jumlah item per halaman.

Default20

is_active?boolean

Filter berdasarkan status aktif resource.

sort_by?string

Nama kolom yang digunakan untuk pengurutan, misalnya name atau created_at.

order?string

Arah pengurutan.

Default"DESC"

Value in"ASC" | "DESC"

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/gateway/v1/whitelist/resources"

{  "data": [    {      "id": 1,      "name": "Face Recognition",      "route": "/v1/util/face-search/demography",      "description": "Endpoint pencarian wajah dengan data demografi Dukcapil.",      "is_active": true,      "created_at": "2025-01-01T00:00:00Z",      "updated_at": "2025-06-01T08:00:00Z"    },    {      "id": 2,      "name": "Plate Recognition",      "route": "/v1/util/no-pol-korlantas",      "description": "Endpoint pencarian plat nomor kendaraan dari Korlantas.",      "is_active": true,      "created_at": "2025-01-01T00:00:00Z",      "updated_at": "2025-06-01T08:00:00Z"    }  ],  "total": 2,  "page": 1,  "page_size": 20,  "total_pages": 1}

Tambah Whitelist Resource

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Nama deskriptif resource.

route*string

Path endpoint yang dilindungi.

description?string

Deskripsi singkat resource (opsional).

is_active?boolean

Status awal resource.

Defaulttrue

Response Body

`application/json`

curl -X POST "https://lenz.example.com/api/gateway/v1/whitelist/resources" \  -H "Content-Type: application/json" \  -d '{    "name": "NIK Search",    "route": "/v1/util/nik-search"  }'

{  "message": "resource created successfully",  "data": {    "id": 3,    "name": "NIK Search",    "route": "/v1/util/nik-search",    "description": "Pencarian data penduduk berdasarkan NIK.",    "is_active": true,    "created_at": "2026-04-30T08:00:00Z",    "updated_at": "2026-04-30T08:00:00Z"  }}

Detail Whitelist Resource

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik whitelist resource.

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/gateway/v1/whitelist/resources/0"

{  "id": 1,  "name": "Face Recognition",  "route": "/v1/util/face-search/demography",  "description": "Endpoint pencarian wajah dengan data demografi Dukcapil.",  "is_active": true,  "created_at": "2025-01-01T00:00:00Z",  "updated_at": "2025-06-01T08:00:00Z"}

{  "code": 404,  "message": "resource not found"}

Update Whitelist Resource

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik whitelist resource.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

Nama baru resource.

route?string

Path endpoint baru.

description?string

Deskripsi baru.

is_active?boolean

Status aktif resource.

Response Body

`application/json`

curl -X PUT "https://lenz.example.com/api/gateway/v1/whitelist/resources/0" \  -H "Content-Type: application/json" \  -d '{}'

{  "message": "resource updated successfully",  "data": {    "id": 1,    "name": "Face Recognition (Updated)",    "route": "/v1/util/face-search/demography",    "description": "Versi baru endpoint pencarian wajah.",    "is_active": true,    "created_at": "2025-01-01T00:00:00Z",    "updated_at": "2026-04-30T09:00:00Z"  }}

Hapus Whitelist Resource

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik whitelist resource.

Response Body

`application/json`

curl -X DELETE "https://lenz.example.com/api/gateway/v1/whitelist/resources/0"

{  "message": "resource deleted successfully"}

In: header

Query Parameters

page?integer

Nomor halaman, dimulai dari 1.

Default1

limit?integer

Jumlah item per halaman.

Default20

search?string

Pencarian parsial berdasarkan alamat IP, nama resource, atau satuan.

filter[status]?string

Filter berdasarkan status entri.

Value in"active" | "inactive"

filter[type]?integer

Filter berdasarkan whitelist_resource_id.

filter[unit]?string

Filter berdasarkan satuan kuota.

Value in"daily" | "monthly" | "yearly"

filter[ip_address]?string

Filter berdasarkan alamat IP (pencocokan eksak).

filter[valid_after]?string

Filter entri dengan valid_until setelah tanggal tertentu (YYYY-MM-DD).

Formatdate

filter[valid_before]?string

Filter entri dengan valid_until sebelum tanggal tertentu (YYYY-MM-DD).

Formatdate

sort[created_at]?string

Urutkan berdasarkan waktu pembuatan.

Value in"ASC" | "DESC"

sort[ip_address]?string

Urutkan berdasarkan alamat IP.

Value in"ASC" | "DESC"

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/gateway/v1/whitelist/ip-addresses"

{  "ok": true,  "message": "successfully get whitelisted ips",  "results": {    "limit": 20,    "current_page": 1,    "total_data": 2,    "total_page": 1,    "whitelisted_ips": [      {        "id": 42,        "ip_address": "203.0.113.45",        "whitelist_resource_id": 1,        "whitelist_resource": {          "id": 1,          "name": "Face Recognition",          "route": "/v1/util/face-search/demography",          "description": "Endpoint pencarian wajah dengan data demografi Dukcapil.",          "is_active": true,          "created_at": "2025-01-01T00:00:00Z",          "updated_at": "2025-06-01T08:00:00Z"        },        "unit": "monthly",        "quota": 1000,        "unlimited_quota": false,        "valid_until": "2026-12-31",        "status": "active",        "created_at": "2025-01-01T08:00:00Z",        "updated_at": "2025-06-15T10:30:00Z"      }    ]  }}

Tambah IP Whitelist

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

ip_address*string

Alamat IP yang akan diizinkan. Harus berupa IP publik atau IP yang dapat dikenali server Gateway.

whitelist_resource_id*integer

ID resource yang boleh diakses oleh IP ini. Gunakan endpoint GET /api/gateway/v1/whitelist/resources untuk mendapatkan daftar resource yang tersedia.

unit*string

Satuan periode kuota.

Value in"daily" | "monthly" | "yearly"

quota*integer

Jumlah maksimum request yang diizinkan per periode.

unlimited_quota?boolean

Jika true, kuota tidak dibatasi. Field quota tetap dikirim namun diabaikan.

Defaultfalse

valid_until?string

Tanggal kedaluwarsa format YYYY-MM-DD. Kosongkan (null) jika tidak ada batas waktu.

Formatdate

status*string

Status awal entri setelah dibuat.

Value in"active" | "inactive"

Response Body

`application/json`

curl -X POST "https://lenz.example.com/api/gateway/v1/whitelist/ip-addresses" \  -H "Content-Type: application/json" \  -d '{    "ip_address": "203.0.113.45",    "whitelist_resource_id": 1,    "unit": "monthly",    "quota": 1000,    "status": "active"  }'

{  "ok": true,  "message": "successfully created whitelisted ip",  "whitelisted_ip": {    "id": 42,    "ip_address": "203.0.113.45",    "whitelist_resource_id": 1,    "whitelist_resource": {      "id": 1,      "name": "Face Recognition",      "route": "/v1/util/face-search/demography",      "description": "Endpoint pencarian wajah dengan data demografi Dukcapil.",      "is_active": true,      "created_at": "2025-01-01T00:00:00Z",      "updated_at": "2025-06-01T08:00:00Z"    },    "unit": "monthly",    "quota": 1000,    "unlimited_quota": false,    "valid_until": "2026-12-31",    "status": "active",    "created_at": "2026-04-30T08:00:00Z",    "updated_at": "2026-04-30T08:00:00Z"  }}

{  "ok": false,  "code": "validation-error",  "errors": [    "ip_address is required"  ],  "message": "validation failed"}

Detail IP Whitelist

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik entri IP whitelist.

Response Body

`application/json`

curl -X GET "https://lenz.example.com/api/gateway/v1/whitelist/ip-addresses/0"

{  "ok": true,  "message": "successfully get whitelisted ip",  "whitelisted_ip": {    "id": 42,    "ip_address": "203.0.113.45",    "whitelist_resource_id": 1,    "whitelist_resource": {      "id": 1,      "name": "Face Recognition",      "route": "/v1/util/face-search/demography",      "description": "Endpoint pencarian wajah dengan data demografi Dukcapil.",      "is_active": true,      "created_at": "2025-01-01T00:00:00Z",      "updated_at": "2025-06-01T08:00:00Z"    },    "unit": "monthly",    "quota": 1000,    "unlimited_quota": false,    "valid_until": "2026-12-31",    "status": "active",    "created_at": "2025-01-01T08:00:00Z",    "updated_at": "2025-06-15T10:30:00Z"  }}

{  "ok": false,  "code": "not-found",  "errors": [],  "message": "whitelisted ip not found"}

Update IP Whitelist

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik entri IP whitelist.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

ip_address*string

Alamat IP (tidak dapat diubah, harus sama dengan nilai saat ini).

whitelist_resource_id*integer

ID resource yang boleh diakses.

unit*string

Satuan periode kuota.

Value in"daily" | "monthly" | "yearly"

quota*integer

Jumlah maksimum request yang diizinkan per periode.

unlimited_quota?boolean

Jika true, kuota tidak dibatasi.

Defaultfalse

valid_until?string

Tanggal kedaluwarsa baru (YYYY-MM-DD). Null berarti tidak ada batas waktu.

Formatdate

status*string

Status entri.

Value in"active" | "inactive"

Response Body

`application/json`

curl -X PUT "https://lenz.example.com/api/gateway/v1/whitelist/ip-addresses/0" \  -H "Content-Type: application/json" \  -d '{    "ip_address": "203.0.113.45",    "whitelist_resource_id": 1,    "unit": "monthly",    "quota": 2000,    "status": "active"  }'

{  "ok": true,  "message": "successfully updated whitelisted ip"}

Hapus IP Whitelist

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID numerik entri IP whitelist.

Response Body

`application/json`

curl -X DELETE "https://lenz.example.com/api/gateway/v1/whitelist/ip-addresses/0"

{  "ok": true,  "message": "successfully deleted whitelisted ip"}

API Reference — Gateway

← Kembali ke Gateway

Otentikasi

200application/json

200application/json

200application/json

404application/json

200application/json

200application/json

200application/json

200application/json

422application/json

200application/json

404application/json

200application/json

200application/json

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`