T
Tick Up
Nhà phát triển
Đăng ký tài khoản
Tài liệu API

Phỏng vấn

Một interview gắn một đơn ứng tuyển với khung giờ đã lên lịch, một hoặc nhiều người phỏng vấn, và template phản hồi có cấu trúc.

Object Interview

json
{
  "id": "9f8e7d6c-...-1a2b",
  "application_id": "1a2b3c4d-...-5e6f",
  "scheduled_at": "2026-05-15T07:00:00.000Z",
  "duration_minutes": 60,
  "format": "video_call",
  "location": "https://meet.google.com/abc-defg-hij",
  "status": "scheduled",
  "interviewers": [
    { "user_id": "...", "full_name": "Le Quoc Anh" }
  ],
  "evaluation_template_id": "..."
}

Trường chính

TrườngKiểuMô tả
statusstring`scheduled`, `confirmed` (ứng viên đã xác nhận), `completed`, `cancelled`, `no_show`.
formatstring`onsite`, `video_call`, `phone_call`.
locationstringVăn bản tự do. Với video call, điền link meeting; với onsite, điền địa chỉ.

Lên lịch phỏng vấn

POST /api/v1/interviews lên lịch buổi phỏng vấn mới cho một đơn ứng tuyển và gửi cho ứng viên link token đã ký để họ có thể xác nhận, đổi giờ, hoặc từ chối. Trường bắt buộc trong body: application_id, scheduled_at (UTC), và format. Tùy chọn: duration_minutes (mặc định 60), location, interviewer_user_ids, và evaluation_template_id để điền sẵn form phản hồi.

shell
curl -X POST https://tickup-api.onrender.com/api/v1/interviews \
  -H "Authorization: Bearer $TICKUP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application_id": "1a2b3c4d-...-5e6f",
    "scheduled_at": "2026-05-15T07:00:00.000Z",
    "duration_minutes": 60,
    "format": "video_call",
    "location": "https://meet.google.com/abc-defg-hij",
    "interviewer_user_ids": ["..."]
  }'

Đổi lịch hoặc hủy

Dùng POST /api/v1/interviews/{interview_id}/reschedule để dời buổi phỏng vấn sang giờ mới — ứng viên nhận link xác nhận đã cập nhật. Không có verb hủy chuyên dụng; DELETE /api/v1/interviews/{interview_id} sẽ hủy (xóa mềm + email thông báo cho ứng viên).

Luồng xác nhận của ứng viên

Tick Up gửi ứng viên một URL có token đã ký dạng https://tickup.vn/i/{token}. Ứng viên xác nhận, đổi giờ trong các slot đã cấu hình, hoặc từ chối — không cần đăng nhập. Hành động của họ cập nhật trạng thái buổi phỏng vấn qua endpoint nội bộ; bạn không gọi trực tiếp các endpoint đó.

Thu thập phản hồi

Sau khi buổi phỏng vấn kết thúc, người phỏng vấn hoàn tất một evaluation — một form có cấu trúc tạo từ evaluation_template. POST /api/v1/evaluations nộp evaluation đã hoàn tất gắn với buổi phỏng vấn và kích hoạt mọi automation phía sau đã cấu hình (ví dụ tự chuyển vòng khi phản hồi tích cực).

Người phỏng vấn không có tài khoản Tick Up cũng nhận link công khai một-lần — xem các endpoint public/interviews/*/{token} (respond, schedule, feedback, interviewer-respond) trong tài liệu đầy đủ.

Tích hợp lịch

Nếu người phỏng vấn đã kết nối Google Calendar trong cài đặt Tick Up, lên lịch phỏng vấn cũng sẽ tạo sự kiện lịch với ứng viên là người được mời. Endpoint vẫn vậy — hiệu ứng phụ chạy tự động.

    Phỏng vấn | Tick Up Developers