快速開始

申請連結、開啟它，需要的話再放進你自己的網頁。

你需要
Anping 的網址
給你的程式用的秘密金鑰（API 金鑰）
一組電腦設定的名稱（model id）
由管理 Anping 伺服器的人提供（部署）

model 就是在 Anping 裡設定好的一台電腦，連同它的設定（model）。

1申請連結

從你的伺服器送出，不要從瀏覽器。用表單方式送出（POST），金鑰就不會出現在網址和記錄裡。

curl -X POST https://anping.example.com/ws/oturl/get \
  --data-urlencode "apikey=$ANPING_API_KEY" \
  --data-urlencode "apiuser=alice@example.com" \
  --data-urlencode "model=sales-desktop"

Anping 回傳連結的後半段，純文字：

/oturl.html?key=<43 characters>&pass=<8 characters>

從 Thinfinity 移過來？你現在的請求（GET）照樣可用（什麼時候改成 POST）。

2開啟連結

https://anping.example.com/oturl.html?key=...&pass=...

時機	會發生什麼
開啟時	頁面先把網址裡的機密部分（key 和 pass）拿掉，再連線。
還沒用過	`expires` 分鐘後失效（預設 10）。
重新整理、重新連線	只限開啟它的瀏覽器：最後一次斷線後 10 分鐘內，最多到第一次開啟後 12 小時。
其他瀏覽器	This link has already been used or has expired.
model 沒有使用者名稱或密碼	頁面請使用者輸入。

要從你的網頁用 window.open 打開？請在使用者點擊的當下就開新分頁，否則瀏覽器可能會把它當成彈出式視窗擋掉（做法）。

3內嵌（選用）

先在 Anping 伺服器的 Oturl:FrameAncestors 允許你網站的網址（來源），例如 Oturl__FrameAncestors__0=https://app.example.com。然後：

<iframe src="https://anping.example.com/oturl.html?key=...&pass=..."
        title="Remote desktop"
        allow="fullscreen; clipboard-read; clipboard-write; autoplay"
        referrerpolicy="no-referrer"
        style="width: 100%; height: 80vh; border: 0"></iframe>

重新整理、聲音和送給你網頁的訊息：內嵌。

調整連結開啟的內容

在申請時加上更多選項（OTURL 參數）。有指定 model 時，要加上 overrideDefaults=true 才算數。所有選項：API 參考；現成程式碼：範例。

範例：固定大小、關閉剪貼簿

curl -X POST https://anping.example.com/ws/oturl/get \
  --data-urlencode "apikey=$ANPING_API_KEY" \
  --data-urlencode "apiuser=alice@example.com" \
  --data-urlencode "model=sales-desktop" \
  --data-urlencode "overrideDefaults=true" \
  --data-urlencode "resolution=fixed" \
  --data-urlencode "width=1280" \
  --data-urlencode "height=800" \
  --data-urlencode "clipboard=false"