Tài liệu không gian làm việc

Tài liệu không gian làm việc Lynko

Tìm hiểu cách tùy chọn không gian làm việc Lynko, quyền truy cập API nhà phát triển, webhooks và phân tích kết hợp với nhau để bạn tạo liên kết, mã QR và luồng chiến dịch tự tin hơn.

Mở không gian làm việc Nhà phát triển Tải đặc tả OpenAPI

Tổng quan không gian làm việc

Một không gian làm việc cho mọi điểm chạm công khai

Không gian làm việc Lynko giữ liên kết công khai, mã QR, trang, chiến dịch và báo cáo của bạn trong một nơi. Mỗi công cụ có thể dùng riêng, nhưng workflow mạnh nhất sẽ kết hợp chung.

Liên kết rút gọn

Tạo liên kết gọn gàng để chia sẻ với theo dõi tùy chọn, quy tắc hết hạn, mật khẩu, Smart Redirects và thống kê công khai.

Mã QR động

Tạo mã QR có thể giữ nguyên mã đã in trong khi điểm đến được đổi sau.

Trang liên kết

Xuất bản trang link-in-bio cho hồ sơ social, chiến dịch, sự kiện và điểm đến quan trọng.

Bộ chiến dịch

Gom liên kết rút gọn, mã QR, landing page, bình chọn, khối Reward Unlock và báo cáo quanh một chương trình quảng bá.

Thẻ thông minh

Chuẩn bị card in ấn hoặc kỹ thuật số với điểm đến QR có thể cập nhật từ không gian làm việc.

Poll và trang AMA

Thu thập bình chọn hoặc câu hỏi từ khán giả và xem hoạt động từ cùng một tài khoản.

Action Hub

Chia sẻ liên kết quyên góp, shop, liên hệ và cộng đồng từ một trang hỗ trợ công khai.

Bộ đếm và Insight Pixel

Đo lượt truy cập bằng bộ đếm nhẹ và phân tích không gian làm việc thân thiện với riêng tư.

Workspace options

Những gì bạn có thể quản lý từ dashboard

Tùy chọn không gian làm việc bao gồm tạo nội dung, phân tích, import, export, quyền nhà phát triển và kiểm soát hướng đến riêng tư. Giới hạn gói áp dụng cho tài sản đang hoạt động hoặc có theo dõi, còn liên kết rút gọn không theo dõi vẫn không giới hạn.

Quản lý tài sản

Tạo, sửa, tạm dừng, khôi phục và sắp xếp tài sản Lynko công khai từ dashboard.

Phân tích

Xem click, scan, lượt xem, bình chọn, referrer, thiết bị, ngôn ngữ và kết quả chiến dịch khi theo dõi được bật.

Giới hạn theo gói

Short liên kết có theo dõi, trang đã xuất bản, mã QR đang hoạt động, Smart Card, poll, bộ đếm, pixel, nút Action Hub và Campaign Kit tuân theo giới hạn gói.

Import và export

Di chuyển dữ liệu không gian làm việc vào và ra bằng CSV và công cụ export được hỗ trợ khi gói của bạn cho phép.

Developer access

Tạo API key có phạm vi, kết nối webhook và tự động hóa các Hành động không gian làm việc được hỗ trợ.

Kiểm soát riêng tư

Dùng phân tích thân thiện với riêng tư, URL Lynko gốc, upload an toàn và kiểm tra quyền sở hữu trong các công cụ không gian làm việc.

API nhà phát triển

Bắt đầu nhanh với API

API Lynko là API JSON toàn nền tảng cho tự động hóa không gian làm việc. Tạo API key trong không gian làm việc Nhà phát triển, chỉ chọn quyền mà tích hợp cần, rồi gửi request đến URL gốc của API.

URL gốc /api/v1
Xác thực X-API-Key or Authorization: Bearer API_KEY
Định dạng phản hồi Raw JSON
OpenAPI /openapi.json

Xác thực

Dùng X-API-Key để xác thực API ổn định nhất. Token Authorization Bearer cũng được hỗ trợ khi môi trường hosting chuyển header Authorization đến PHP.

Phản hồi 401 có nghĩa là key không được chấp nhận. Hãy kiểm tra key còn hoạt động, chưa bị thu hồi, được sao chép không có khoảng trắng và thuộc về API host bạn đang gọi.

Giới hạn tốc độ API theo gói
Gói Request mới phút Request mới ngày
Free / Bronze 20 1000
Bạc 60 5000
Vàng 120 20000

Lệnh đọc dùng giới hạn bình thường. Lệnh ghi và Tóm tắt phân tích vừa giới hạn chặt hơn, còn export, test webhook và upload nhỏ vừa giới hạn chặt nhất.

Ví dụ sử dụng

Dùng API theo nhiều cách

Các Ví dụ này cho thấy mẫu thường dùng. Thay YOUR_API_KEY bằng key có phạm vi từ không gian làm việc Nhà phát triển và giữ key riêng tư.

Ví dụ JavaScript phải chạy trong console trình duyệt hoặc Node.js, không chạy trực tiếp trong Windows PowerShell. Với PowerShell, hãy dùng Ví dụ Windows PowerShell.

Kiểm tra API key

curl -H "X-API-Key: YOUR_API_KEY" https://lynko.tv/api/v1/me

Tạo liên kết rút gọn bằng cURL

curl -X POST https://lynko.tv/api/v1/shortlinks \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/landing","title":"Campaign launch"}'

Tạo mã QR bằng JavaScript

const response = await fetch('https://lynko.tv/api/v1/qr-codes', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    target_url: 'https://example.com/menu',
    title: 'Menu QR code'
  })
});

const qrCode = await response.json();

Tạo mã QR bằng Windows PowerShell

$headers = @{
  'X-API-Key' = 'YOUR_API_KEY'
}

$body = @{
  target_url = 'https://example.com/menu'
  title = 'Menu QR code'
} | ConvertTo-Json

$response = Invoke-RestMethod `
  -Uri 'https://lynko.tv/api/v1/qr-codes' `
  -Method Post `
  -Headers $headers `
  -ContentType 'application/json' `
  -Body $body

$response

Đọc phân tích bằng PHP

<?php
$ch = curl_init('https://lynko.tv/api/v1/analytics/summary');
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
  CURLOPT_RETURNTRANSFER => true,
]);
$json = curl_exec($ch);
curl_close($ch);
$summary = json_decode((string)$json, true);

Tự động hóa thiết lập chiến dịch

Tạo liên kết rút gọn, tạo mã QR cho cùng điểm đến, rồi xem hiệu suất từ phân tích.

Đồng bộ điểm đến công khai

Cập nhật trang liên kết, Smart Card, Action Hub hoặc điểm đến QR từ công cụ nội bộ của bạn.

Xay dùng dashboard báo cáo

Lấy tóm tắt phân tích không gian làm việc và kết hợp với ghi chú chiến dịch hoặc báo cáo khách hàng của bạn.

Nhận sự kiện bằng webhook

Dùng webhook cho click liên kết, scan QR, gửi capture, lead chiến dịch, vote poll và thay đổi billing.

Quyền và endpoint

Chọn bộ quyền nhỏ nhất nhưng đủ dùng

API key có phạm vi. Mỗi tích hợp chỉ nên có quyền cần thiết, sau đó xoay vòng hoặc thu hồi key từ không gian làm việc Nhà phát triển khi không cần truy cập nữa.

Tài khoản

  • account:readĐọc email tài khoản và chi tiết gói

Asset chính

  • links:readĐọc shortlink
  • links:writeTạo và cập nhật shortlink
  • qr:readĐọc mã QR
  • qr:writeTạo và cập nhật mã QR
  • trees:readĐọc trang link
  • trees:writeTạo và cập nhật trang link

Tương tác

  • polls:readĐọc poll
  • polls:writeTạo và cập nhật poll
  • ama:readĐọc trang AMA
  • ama:writeQuản lý trang AMA
  • capture:readĐọc data Reward Unlock
  • capture:writeQuản lý block Reward Unlock

Công cụ không gian làm việc

  • campaigns:readĐọc Campaign Kits
  • campaigns:writeTạo và cập nhật Campaign Kits
  • cards:readĐọc Smart Cards
  • cards:writeTạo và cập nhật Smart Cards
  • counters:readĐọc bộ đếm và Insight Pixels
  • counters:writeTạo và cập nhật bộ đếm và Insight Pixels
  • support:readĐọc Action Hub
  • support:writeQuản lý Action Hub
  • drops:readĐọc Creator Drops
  • drops:writeTạo và cập nhật Creator Drops

Tích hợp

  • analytics:readĐọc Tóm tắt phân tích
  • webhooks:writeQuản lý webhook
  • uploads:writeUpload media API nhỏ

Tài khoản

GET /api/v1/me Chi tiết tài khoản và khóa API account:read for email and subscription details
GET /api/v1/rate-limits Giới hạn gói hiện tại và chi phí endpoint -

Asset chính

GET /api/v1/shortlinks Liệt kê shortlink links:read
POST /api/v1/shortlinks Tạo shortlink links:write
GET /api/v1/qr-codes Liệt kê mã QR qr:read
POST /api/v1/qr-codes Tạo mã QR qr:write
GET /api/v1/link-pages Liệt kê trang link trees:read
POST /api/v1/link-pages Tạo trang link trees:write

Tương tác

GET /api/v1/polls Liệt kê poll polls:read
POST /api/v1/polls Tạo poll polls:write
GET /api/v1/ama Đọc cài đặt AMA ama:read
POST /api/v1/ama Tạo hoặc cập nhật cài đặt AMA ama:write
GET /api/v1/capture/blocks Liệt kê block Reward Unlock capture:read
POST /api/v1/capture/blocks Tạo hoặc cập nhật block Reward Unlock capture:write
GET /api/v1/capture/submissions Liệt kê submission Reward Unlock capture:read

Công cụ không gian làm việc

GET /api/v1/campaign-kits Liệt kê Campaign Kits campaigns:read
POST /api/v1/campaign-kits Tạo Campaign Kit campaigns:write
GET /api/v1/smart-cards Liệt kê Smart Cards cards:read
POST /api/v1/smart-cards Tạo Smart Card cards:write
GET /api/v1/counters Liệt kê bộ đếm và Insight Pixels counters:read
POST /api/v1/counters Tạo bộ đếm hoặc Insight Pixel counters:write
GET /api/v1/support-hub Đọc cài đặt Action Hub support:read
PUT /api/v1/support-hub Cập nhật cài đặt Action Hub support:write
GET /api/v1/creator-drops Liệt kê Creator Drops drops:read
POST /api/v1/creator-drops Tạo Creator Drop drops:write
POST /api/v1/creator-drops/{id}/images Upload một ảnh Creator Drop drops:write + uploads:write

Tích hợp

GET /api/v1/analytics/summary Đọc Tóm tắt phân tích không gian làm việc analytics:read
GET /api/v1/webhooks Liệt kê endpoint webhook webhooks:write
POST /api/v1/webhooks Tạo endpoint webhook webhooks:write
PATCH /api/v1/webhooks/{id} Cập nhật endpoint webhook webhooks:write
DELETE /api/v1/webhooks/{id} Xóa endpoint webhook webhooks:write
POST /api/v1/webhooks/{id}/test Dua event test webhook vào hàng đợi webhooks:write

Các bước tiếp theo

Link không gian làm việc hữu ích

Dùng các trang này khi bạn sẵn sàng tạo API key, kết nối webhook, export dữ liệu hoặc cần hỗ trợ tích hợp.

Mở không gian làm việc Nhà phát triển Tạo API key, xem giới hạn và quản lý quyền nhà phát triển. Tải đặc tả OpenAPI Dùng mô tả API đọc được bằng máy trong công cụ nhà phát triển. Quản lý webhook Kết nối gửi sự kiện cho các Hành động không gian làm việc được hỗ trợ. Import và export dữ liệu Di chuyển dữ liệu không gian làm việc bằng công cụ dashboard được hỗ trợ. Liên hệ hỗ trợ Hỏi hỗ trợ về thiết lập không gian làm việc, truy cập API hoặc câu hỏi tích hợp.