Skip to content

SDKs Chính thức (TypeScript & PHP) & Sandbox

This content is not available in your language yet.

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);
}
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]);

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.

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.