Skip to main content
Developer

Matthews Wong API

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.

Sekilas

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

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. 1

    Lihat daftar endpoint

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

    curl https://www.matthewswong.com/api/v1/
  2. 2

    Bertanya ke asisten

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

    curl -N https://www.matthewswong.com/api/v1/chat/ \
      -H "Content-Type: application/json" \
      -d '{"message": "What does Matthews Wong work on?"}'
  3. 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.

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

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.

Halaman kontak
Referensi

Endpoint

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

MetodePathFungsiBatas 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
Error

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.

Request yang terkena rate limit

{
  "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
}
KodeStatusArti
invalid_json400Body bukan JSON yang valid.
invalid_request400Ada field yang hilang atau di luar batas; hint menyebutkannya.
rejected_input400Input ditolak, misalnya upaya mengganti instruksi asisten.
not_found404Tidak ada endpoint di path itu; hint menyebut yang benar.
method_not_allowed405Metode salah; header Allow menyebut yang benar.
rate_limited429Terlalu banyak request; tunggu retryAfter detik.
service_unavailable500Server kekurangan dependensi yang dibutuhkan; coba lagi nanti.
internal_error500Kegagalan server yang tidak terduga; coba lagi nanti.
upstream_error502Penyedia email menolak pesan.
Versi

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

PathGunakanDeprecated sejakSunset
/api/chat//api/v1/chat/2026-10-08Belum dijadwalkan
/api/chat/followups//api/v1/chat/followups/2026-10-08Belum dijadwalkan
/api/contact//api/v1/contact/2026-10-08Belum dijadwalkan

Yang dikirim endpoint deprecated

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"
Sandbox

Coba endpoint asisten

Ini mengirim request sungguhan ke POST /api/v1/chat/ dari browser Anda dan mengalirkan jawabannya, sama seperti klien lain. Request ini dihitung dalam rate limit yang sama.

POST/api/v1/chat/
Response
Jawaban yang dialirkan muncul di sini.
Machine-readable

Sumber untuk tools dan agen

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

  • OpenAPI 3.1

    www.matthewswong.com/openapi.json

    Impor ke Postman, Insomnia, atau generator klien.

  • API index

    www.matthewswong.com/api/v1/

    Daftar endpoint dan versi, dalam JSON.

  • API catalog (RFC 9727)

    www.matthewswong.com/.well-known/api-catalog

    URL well-known standar untuk menemukan API ini.

  • llms.txt

    www.matthewswong.com/llms.txt

    Indeks situs untuk model bahasa.

  • llms-full.txt

    www.matthewswong.com/llms-full.txt

    Indeks beserta ringkasan setiap artikel.

  • Sitemap

    www.matthewswong.com/sitemap.xml

    Setiap halaman, dalam dua bahasa.

  • RSS

    www.matthewswong.com/feed.xml

    Artikel baru begitu terbit.

  • JSON Feed

    www.matthewswong.com/feed.json

    Feed yang sama, dalam JSON.

  • RSS (Bahasa Indonesia)

    www.matthewswong.com/id/feed.xml

    Artikel yang sama, dalam bahasa Indonesia.