Download the PHP package trisnawan/translator-client-php without Composer
On this page you can find all versions of the php package trisnawan/translator-client-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download trisnawan/translator-client-php
More information about trisnawan/translator-client-php
Files in trisnawan/translator-client-php
Package translator-client-php
Short Description Asynchronous PHP client for the Translator REST API: queue translations and verify signed webhook callbacks.
License MIT
Informations about the package translator-client-php
Translator Client for PHP
Client PHP tanpa dependensi (hanya curl) untuk REST API Translator — fokus pada alur asynchronous:
- Kirim permintaan terjemahan dengan
Translator::translate()→POST /translate(autentikasikey_id+ signature token). - Terima hasilnya di webhook, sudah diverifikasi otomatis oleh
Webhook::validData().
Kontrak API lengkap ada di API_DOC.md.
Persyaratan
- PHP >= 8.1
- ekstensi
curl
Instalasi
Alur
1. Mengirim Terjemahan
translate() menandatangani request dengan secret_key lalu mengembalikan data dari API (history_id, status, callback_enabled, ...). Hasil terjemahan tidak dibalas di sini — hasilnya dikirim ke webhook Anda.
Bahasa bisa di-override per panggilan:
Parameter translate()
| Parameter | Wajib | Keterangan |
|---|---|---|
$driver |
✅ | id driver yang diberikan ke akun, mis. gemini-3.8-flash |
$referenceId |
✅ | id milik Anda; diikat ke signature token dan dicocokkan saat callback |
$referenceContent |
✅ | teks yang akan diterjemahkan |
$from / $to |
– | override bahasa; default dari constructor |
Parameter constructor
| Parameter | Default | Keterangan |
|---|---|---|
$baseUrl |
– | alamat API, mis. http://localhost:3000 |
$accountId |
– | UUID akun pemilik API key (dipakai pada signature token) |
$keyId |
– | id pada account_keys |
$secretKey |
– | secret_key milik key tersebut |
$from / $to |
null |
bahasa default untuk semua translate() |
$tokenTtl |
300 |
masa berlaku signature token (detik) |
$timeout |
30 |
timeout HTTP request (detik) |
Jika callback_enabled bernilai false (key tanpa callback_url), hasil harus diambil manual lewat dashboard/GET /histories — di luar cakupan library ini.
2. Menerima Callback
Pasang endpoint webhook Anda sebagai callback_url pada API key, lalu verifikasi sekaligus baca payload-nya hanya dengan validData():
validData() secara otomatis memverifikasi:
- header
key_idcocok dengan key yang Anda berikan, - signature token HS256 benar-benar ditandatangani dengan
secret_keyAnda, - token belum kedaluwarsa,
reference_idpada body sama denganreference_iddi dalam token,statusbernilaitranslatedataufailed.
Semua kegagalan melempar WebhookException; payload yang valid dikembalikan sebagai array.
Balas 2xx hanya jika tidak ada exception, karena selain itu server akan menjadwalkan ulang callback (default 5 menit, maksimal 2 percobaan).
Payload callback
| Field | Tipe | Keterangan |
|---|---|---|
status |
string | translated atau failed |
translate_from |
string | kode bahasa sumber |
translate_to |
string | kode bahasa tujuan |
reference_id |
string | sama dengan yang dikirim saat translate() |
translated_content |
string | null | hasil terjemahan; null bila failed |
translated_at |
string | null | waktu selesai (ISO 8601) |
Integrasi framework
validData() membaca $_SERVER + php://input. Bila framework Anda punya request sendiri, inject keduanya:
Nama header dicocokkan tanpa peduli bentuk dan huruf besar/kecil — key_id, Key-Id, maupun HTTP_KEY_ID sama-sama dikenali, jadi array mentah dari getallheaders() juga bisa di-inject sebagai $server.
Bila aplikasi Anda punya beberapa API key, baca header key_id lebih dulu untuk menentukan secret_key yang sesuai, baru panggil validData($keyId, $secretKey).
Penanganan Error
| Exception | Kapan muncul | Info tambahan |
|---|---|---|
TranslatorException |
base semua error library | – |
ApiException |
API membalas non-2xx (signature salah, driver tidak diberi akses, quota habis, broker down, ...) | getStatusCode(), getErrors() |
WebhookException |
callback tidak valid / tidak terautentikasi | – |
Lisensi
MIT — lihat LICENCE.txt.
All versions of translator-client-php with dependencies
ext-curl Version *