Đăng nhập để lấy khoá

Khoá API gắn với ví credit nên phải có tài khoản (số điện thoại + mật khẩu). Gắn bằng cookie thì đổi máy hoặc xoá cookie là mất sạch khoá lẫn bảng giá.

Dùng thế nào

Ba bước. Mọi lượt gọi gửi header Authorization: Bearer sg_live_….

# 1. Xin chỗ đẩy file lên
curl -X POST https://sigo3d.vn/v1/uploads \
  -H "Authorization: Bearer $SIGO_KEY" -H "Content-Type: application/json" \
  -d '{"name":"vo-hop.stl","size":845120}'
# -> {"ok":true,"file_id":"a1b2….stl","upload_url":"https://…"}

# 2. PUT file thẳng lên upload_url (KHÔNG đặt Content-Type)
curl -X PUT --upload-file vo-hop.stl "$UPLOAD_URL"

# 3. Báo giá
curl -X POST https://sigo3d.vn/v1/quote \
  -H "Authorization: Bearer $SIGO_KEY" -H "Content-Type: application/json" \
  -d '{"fileId":"a1b2….stl","material":"PETG","preset":"balanced"}'
# -> {"ok":true,"measure":{"grams":72.4,"machine_seconds":5310,…},
#     "price":{"subtotal":107000,…},"billing":{"credits_charged":1,"cached":false}}

# Đơn nhiều file: gom số đo rồi gọi /v1/quote/total để có tổng
# (khuyến mãi + mức tối thiểu chỉ tính đúng khi nhìn cả đơn).
curl -X POST https://sigo3d.vn/v1/quote/total \
  -H "Authorization: Bearer $SIGO_KEY" -H "Content-Type: application/json" \
  -d '{"lines":[{"name":"vo-hop","material":"PETG","grams":72.4,"machineSeconds":5310,"qty":3}]}'

Số lượng nhân ở /v1/quote/total, không nhân ở /v1/quote. /v1/quote luôn trả số của MỘT đơn vị. Để hai chỗ cùng nhân là cách chắc chắn nhất để một bên quên nhân giờ máy — đơn nhiều bản sẽ thiếu tiền và càng nhiều bản càng thiếu nặng.

Mã lỗi: 401 khoá sai · 402 hết credit · 409 chưa khai bảng giá · 422 file/tham số sai · 429 hết hạn ngạch ngày · 503 chờ quá lâu mà chưa tới lượt (hiếm — hệ thống kẹt thật, không phải đông). Mỗi lỗi kèm error.code để bạn phân nhánh bằng máy, đừng so khớp câu chữ.

Khai bảng giá bằng máy: PUT hoặc POST /v1/pricing — hai verb như nhau. Đọc lại bằng GET /v1/pricing.

File báo giá được giữ 3 ngày rồi tự xoá. Endpoint GET /v1/catalog trả danh sách vật liệu, preset, độ dày lớp và định dạng nhận được — đọc từ đó thay vì chép cứng.