Tweet
Ở bài forum trước em đã giới thiệu về REST API và các phương thức HTTP của nó. Hôm nay, em được nắm giữ “🔑 chiếc chìa khóa thần kỳ” – tức API Token của SiteSpeakAI – trong tay. Nên em muốn ghi lại nhanh trải nghiệm test API bằng Postman – một công cụ cực kỳ tiện lợi cho ai muốn kiểm thử hoặc khám phá API. Nhưng làm thế nào để chuyến thám hiểm này vui vẻ, hiệu quả, lại không lỡ tay đánh rơi cái token siêu quan trọng kia? Cùng theo dõi hướng dẫn “thực chiến” quá trình call API SiteSpeakAI bằng Postman vừa dễ, vừa hay sau nhé!
Bước 1: Khởi động chuyến phiêu lưu – Cài Postman, giữ token như… giữ vàng!
Bước 2: Làm quen “bảng điều khiển” Postman
Trên giao diện Postman, hãy để ý:
Bước 3: Gọi API /query – “Nạp đạn, bắn thử” siêu đơn giản!
Chọn Endpoint: https://api.sitespeak.ai/v1/{chatbot_id}/query – {chatbot_id} là Agent ID được cấp cho mỗi chatbot của SiteSpeakAI có trong Settings
Chọn Method: POST
Headers: Nơi đưa API Token "Chìa khóa" để truy cập vào "Nhà".
Body: Nhập Prompt để hỏi chatbot bằng bảng (ngoài ra có thể nhập bằng JSON)
Nhấn Send và đợi AI trả lời, kết quả trả về dưới dạng JSON
Bước 4: Đọc phản hồi API: Có gì ở bên trong?
"text": Câu trả lời từ chatbot.
"urls": (nếu có bật) – Hiển thị nguồn dữ liệu AI dựa vào khi trả lời.
Một số lưu ý sống còn:
Bước 1: Khởi động chuyến phiêu lưu – Cài Postman, giữ token như… giữ vàng!
- Cài đặt Postman (bản nào cũng được, miễn là mới).
- Lấy API Token từ SiteSpeakAI và hãy giữ nó thật kỹ. Đừng share lung tung, đừng lộ trên màn hình livestream, vì ai cầm được token này là làm mưa làm gió với tài khoản này liền!
Bước 2: Làm quen “bảng điều khiển” Postman
Trên giao diện Postman, hãy để ý:
- Params: Khu cho thông số truy cập, thường dùng cho GET, ít xài cho query chính.
- Headers: Cái này buộc phải có Authorization: Bearer YOUR_TOKEN nhé! Nhớ thêm cả Accept: application/json.
- Body: Sân chơi chính khi gọi endpoint /query, toàn bộ nội dung trò chuyện sẽ “bắn” lên đây.
- HTTPS Method: Riêng với SiteSpeakAI, “chiến” mạnh bằng POST cho endpoint trò chuyện.
Bước 3: Gọi API /query – “Nạp đạn, bắn thử” siêu đơn giản!
Chọn Endpoint: https://api.sitespeak.ai/v1/{chatbot_id}/query – {chatbot_id} là Agent ID được cấp cho mỗi chatbot của SiteSpeakAI có trong Settings
Chọn Method: POST
Headers: Nơi đưa API Token "Chìa khóa" để truy cập vào "Nhà".
- Authorization: Bearer YOUR_TOKEN
- Accept: application/json
Body: Nhập Prompt để hỏi chatbot bằng bảng (ngoài ra có thể nhập bằng JSON)
Nhấn Send và đợi AI trả lời, kết quả trả về dưới dạng JSON
Bước 4: Đọc phản hồi API: Có gì ở bên trong?
"text": Câu trả lời từ chatbot.
"urls": (nếu có bật) – Hiển thị nguồn dữ liệu AI dựa vào khi trả lời.
Một số lưu ý sống còn:
- API Token như két sắt: Lộ ra là xác định, khóa ngay token nếu nghi ngờ có trục trặc!
- Đọc kỹ tài liệu API của SiteSpeakAI để khám phá thêm nhiều cách truy cập API khác
- Check kỹ các thông tin tham số đầu vào để tránh lỗi.