API Access — tạo API key & tích hợp

API Access là gì?

SigoMark cung cấp Public REST API cho phép tích hợp với Zapier, n8n, hoặc code của bạn để:

• Trigger pipeline (keyword research, viết bài, đăng bài)
• Lấy dữ liệu (articles, keywords, jobs)
• Đăng ký webhook nhận thông báo khi job hoàn tất

Yêu cầu: Gói Pro hoặc Agency. Nâng gói ngay →

Tạo API Key

1. Vào Profile → API Keys
2. Nhấn Tạo key mới — đặt nhãn dễ nhớ (ví dụ: "Zapier", "n8n", "My Script")
3. Lưu ngay key vừa hiển thị — key chỉ hiện 1 lần duy nhất

Key có dạng: sk_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789Ab

Xác thực

Thêm header vào mọi request:

Authorization: Bearer sk_your_key_here

Endpoint cơ bản

Lấy thông tin tài khoản

curl https://dashboard.sigomark.com/api/v1/me \
  -H "Authorization: Bearer sk_your_key_here"

Danh sách projects

curl https://dashboard.sigomark.com/api/v1/projects \
  -H "Authorization: Bearer sk_your_key_here"

Trigger keyword research

curl -X POST https://dashboard.sigomark.com/api/v1/projects/{project_id}/keywords/research \
  -H "Authorization: Bearer sk_your_key_here"

Response trả về jobId — dùng để poll trạng thái:

curl https://dashboard.sigomark.com/api/v1/jobs/{jobId} \
  -H "Authorization: Bearer sk_your_key_here"

Tài liệu đầy đủ

Xem tất cả endpoints, schema request/response và thử nghiệm trực tiếp:

👉 API Docs (Swagger UI) →

Rate Limit

Gói	Giới hạn
Pro	120 request/phút
Agency	600 request/phút

Khi vượt giới hạn, API trả về 429 Too Many Requests. Retry sau 60 giây.

Webhooks

Đăng ký webhook để nhận thông báo push (không cần polling):

curl -X POST https://dashboard.sigomark.com/api/v1/webhooks \
  -H "Authorization: Bearer sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["article.generated", "article.published"]
  }'

SigoMark ký payload bằng X-Sigomark-Signature: sha256=... (HMAC-SHA256 với secret trả về khi tạo webhook).