# Matthews Wong API — Dokumentasi Developer, Quickstart, OpenAPI

> Dokumentasi developer Matthews Wong API: REST API publik tanpa key, spesifikasi OpenAPI 3.1, quickstart curl, kode error, kebijakan versi dan sandbox.

URL: https://www.matthewswong.com/id/developers/

API REST publik kecil di balik matthewswong.com: tanyakan pekerjaan Matthews Wong kepada asisten situs, dapatkan pertanyaan lanjutan, atau kirimi dia pesan. Tanpa API key, JSON masuk dan keluar, dideskripsikan dengan OpenAPI 3.1.

- Base URL: https://www.matthewswong.com
- Versi: v1, di path
- Autentikasi: Tidak ada, dibatasi per IP
- Format: JSON, server-sent events

## Request pertama Anda dalam satu menit

Semua perintah di bawah bisa langsung dijalankan dari terminal. Base URL-nya https://www.matthewswong.com, dan setiap path diakhiri garis miring.

### 1. Lihat daftar endpoint

Indeks menyebut setiap endpoint, versi yang berlaku, dan lokasi deskripsi OpenAPI.

```sh
curl https://www.matthewswong.com/api/v1/
```

### 2. Bertanya ke asisten

Jawaban dikirim bertahap sebagai server-sent events: satu objek JSON per baris "data:", diakhiri "done".

```sh
curl -N https://www.matthewswong.com/api/v1/chat/ \
  -H "Content-Type: application/json" \
  -d '{"message": "What does Matthews Wong work on?"}'
```

### 3. Baca halaman apa pun sebagai Markdown

Bukan endpoint, tetapi sering kali itulah yang dibutuhkan agen: kirim Accept: text/markdown ke URL halaman mana pun.

```sh
curl -H "Accept: text/markdown" https://www.matthewswong.com/en/about/
```

## Tidak perlu API key

Semua endpoint bersifat publik dan tanpa autentikasi. Tidak ada pendaftaran, tidak ada key yang perlu diminta, dan tidak ada yang perlu dirotasi: langsung kirim request.

Penggunaan yang wajar dijaga dengan rate limit per IP klien, tercantum per endpoint di bawah. Response melaporkan posisi Anda di X-RateLimit-Limit, X-RateLimit-Remaining dan X-RateLimit-Reset; jika melewati batas, Anda mendapat 429 dengan Retry-After dalam detik.

Butuh batas lebih tinggi untuk integrasi sungguhan? Kirim pesan lewat halaman kontak dan jelaskan apa yang sedang Anda bangun.

## Endpoint

Ketiga operasi menerima body JSON lewat POST. Skema request dan response lengkap ada di deskripsi OpenAPI.

| Metode | Path | Fungsi | Batas per menit |
| --- | --- | --- | --- |
| GET | `/api/v1/` | Daftar endpoint, versi, dan URL OpenAPI. | Tidak ada |
| POST | `/api/v1/chat/` | Bertanya ke asisten tentang Matthews Wong; jawaban dikirim bertahap sebagai server-sent events. | 20 |
| POST | `/api/v1/chat/followups/` | Menyarankan hingga tiga pertanyaan lanjutan untuk jawaban terakhir asisten. Tidak pernah gagal: mengembalikan daftar kosong sebagai gantinya. | 30 |
| POST | `/api/v1/contact/` | Mengirim pesan email ke Matthews Wong, dengan Anda sebagai reply-to. Hanya pesan sungguhan dari manusia. Mengirim ulang pesan yang sama aman: pesan hanya terkirim sekali. | 5 |

## Satu bentuk error di semua endpoint

Setiap kegagalan berupa JSON dengan field yang sama: bercabang berdasarkan code, tampilkan error ke manusia, ikuti hint untuk memulihkan. Field docs menunjuk kembali ke deskripsi OpenAPI.

```json
{
  "success": false,
  "error": "Too many requests. Please try again later.",
  "code": "rate_limited",
  "hint": "Wait 42 seconds before retrying; the limit is 20 requests per minute per client.",
  "docs": "https://www.matthewswong.com/openapi.json",
  "retryAfter": 42
}
```

| Kode | Status | Arti |
| --- | --- | --- |
| `invalid_json` | 400 | Body bukan JSON yang valid. |
| `invalid_request` | 400 | Ada field yang hilang atau di luar batas; hint menyebutkannya. |
| `rejected_input` | 400 | Input ditolak, misalnya upaya mengganti instruksi asisten. |
| `not_found` | 404 | Tidak ada endpoint di path itu; hint menyebut yang benar. |
| `method_not_allowed` | 405 | Metode salah; header Allow menyebut yang benar. |
| `rate_limited` | 429 | Terlalu banyak request; tunggu retryAfter detik. |
| `service_unavailable` | 500 | Server kekurangan dependensi yang dibutuhkan; coba lagi nanti. |
| `internal_error` | 500 | Kegagalan server yang tidak terduga; coba lagi nanti. |
| `upstream_error` | 502 | Penyedia email menolak pesan. |

## Versi dan deprecation

Kontraknya dibuat agar klien yang ditulis hari ini tetap berjalan.

- Versi ada di path, /api/v1/. Kunci versi itu di klien Anda.
- Di dalam satu versi, perubahan hanya bersifat menambah: endpoint baru, field request opsional baru, field response baru. Tidak ada yang dihapus, diganti nama, atau diubah tipenya, jadi abaikan field yang tidak Anda kenal.
- Perubahan yang merusak kompatibilitas dirilis sebagai versi baru, /api/v2/. Versi sebelumnya tetap berjalan minimal 180 hari setelah dinyatakan deprecated.
- Endpoint yang deprecated menjawab dengan header Deprecation (RFC 9745) dan Link ke successor-version, dan deskripsi OpenAPI menandainya deprecated. Begitu tanggal penghapusan ditetapkan, endpoint juga mengirim Sunset (RFC 8594), minimal 90 hari sebelumnya.

### Endpoint deprecated

| Path | Gunakan | Deprecated sejak | Sunset |
| --- | --- | --- | --- |
| `/api/chat/` | `/api/v1/chat/` | 2026-10-08 | Belum dijadwalkan |
| `/api/chat/followups/` | `/api/v1/chat/followups/` | 2026-10-08 | Belum dijadwalkan |
| `/api/contact/` | `/api/v1/contact/` | 2026-10-08 | Belum dijadwalkan |

### Yang dikirim endpoint deprecated

```http
POST /api/chat/

HTTP/1.1 200 OK
Deprecation: @1791417600
Link: <https://www.matthewswong.com/api/v1/chat/>; rel="successor-version", <https://www.matthewswong.com/en/developers/#versioning>; rel="deprecation"; type="text/html", <https://www.matthewswong.com/openapi.json>; rel="service-desc"
```

## Sumber untuk tools dan agen

URL tetap yang mendeskripsikan API ini dan situsnya, untuk generator kode, klien API, dan model bahasa.

- [OpenAPI 3.1](https://www.matthewswong.com/openapi.json): Impor ke Postman, Insomnia, atau generator klien.
- [API index](https://www.matthewswong.com/api/v1/): Daftar endpoint dan versi, dalam JSON.
- [API catalog (RFC 9727)](https://www.matthewswong.com/.well-known/api-catalog): URL well-known standar untuk menemukan API ini.
- [llms.txt](https://www.matthewswong.com/llms.txt): Indeks situs untuk model bahasa.
- [llms-full.txt](https://www.matthewswong.com/llms-full.txt): Indeks beserta ringkasan setiap artikel.
- [Sitemap](https://www.matthewswong.com/sitemap.xml): Setiap halaman, dalam dua bahasa.
- [RSS](https://www.matthewswong.com/feed.xml): Artikel baru begitu terbit.
- [JSON Feed](https://www.matthewswong.com/feed.json): Feed yang sama, dalam JSON.
- [RSS (Bahasa Indonesia)](https://www.matthewswong.com/id/feed.xml): Artikel yang sama, dalam bahasa Indonesia.

---

- HTML version: https://www.matthewswong.com/id/developers/
- English: https://www.matthewswong.com/en/developers/
- Site index for agents: https://www.matthewswong.com/llms.txt
- Sitemap: https://www.matthewswong.com/sitemap.xml
- API description (OpenAPI): https://www.matthewswong.com/openapi.json
