SDKs Chính thức (TypeScript & PHP) & Sandbox
This content is not available in your language yet.
TypeScript / Node.js SDK (@trolypage/public-sdk)
Phần tiêu đề “TypeScript / Node.js SDK (@trolypage/public-sdk)”import { TrolyPageClient, verifyWebhookSignature } from '@trolypage/public-sdk';
const client = new TrolyPageClient({ token: process.env.TROLYPAGE_API_TOKEN!, sandbox: true, // gọi https://sandbox-api.trolypage.com/v1});
const created = await client.post('/customers', { name: 'Nguyen Van A', phone: '0901234567' });
for await (const order of client.paginate('/orders')) { console.log(order.id, order.total);}PHP SDK (trolypage/public-sdk)
Phần tiêu đề “PHP SDK (trolypage/public-sdk)”use TrolyPage\PublicSdk\TrolyPageClient;use TrolyPage\PublicSdk\WebhookVerifier;
$client = new TrolyPageClient(token: getenv('TROLYPAGE_API_TOKEN'), sandbox: true);$customer = $client->post('/customers', ['name' => 'Nguyen Van A']);
$isValid = WebhookVerifier::verify($rawBody, $signatureHeader, ['kid_1' => $webhookSecret]);Môi trường Sandbox
Phần tiêu đề “Môi trường Sandbox”Sandbox chạy trên instance và cơ sở dữ liệu riêng. Tạo tp_test_* từ Developer Console của sandbox và gọi https://sandbox-api.trolypage.com/v1. Đơn hàng, lịch hẹn và hồ sơ tạo trong sandbox chỉ xuất hiện ở sandbox. Kết quả mô phỏng có trạng thái riêng.
Gửi lại một yêu cầu
Phần tiêu đề “Gửi lại một yêu cầu”Giữ nguyên Idempotency-Key khi retry. Response có Idempotency-Replayed: true chứa các ID để tra cứu kết quả hiện tại. Credential và secret chỉ xuất hiện trong lần cấp đầu tiên. Nếu mất response cấp credential, hãy cấp hoặc xoay secret qua luồng tương ứng.
