深色模式

開始使用

第一個請求

建立一個 LapidClient，就能以證券代號取得資料；SDK 會自動處理授權、快取、重試與換版。

本版的開發用授權服務只接受 debug 類型的證明，所以範例使用 DebugAttestationProvider。正式環境需要 iOS App Attest 或 Android Play Integrity，須待正式授權服務上線後才能使用，請勿用於上架版 App。
iOS
import LapidSDK

let client = LapidClient(configuration: LapidConfiguration(
    appKey: appKey,
    baseURL: URL(string: "https://sdk-api.lapidinsight.com")!,
    attestation: DebugAttestationProvider(payload: testAttestation)))

let id = try await client.resolveSecurity(.symbol("2330"))
let price = try await client.priceDaily(securityId: id)
Android
val client = LapidClient(context, LapidConfig(
    appKey = appKey,
    baseUrl = "https://sdk-api.lapidinsight.com",
    attestation = DebugAttestationProvider(testAttestation)))

val price = client.priceDaily(client.resolve(SecurityRef.Symbol("2330")))
// 不再使用時呼叫 client.close()

Web SDK 不做裝置驗證，由你的後端取得 token 後交給 tokenSource。

Web
import { LapidClient } from '@lapid/sdk-core';

const client = new LapidClient({
  baseUrl: 'https://sdk-api.lapidinsight.com',
  tokenSource: { getToken: async () => fetchTokenFromYourBackend() },
});
const { release } = await client.getReleaseCurrent();

回傳內容

日 K 為欄式陣列，每個欄位一個陣列、舊到新，第 i 個元素對應同一天。欄位與單位見 日 K。

沒有資料時

某個資料集可能對某檔證券不存在，這不是錯誤，畫面應顯示「無資料」。興櫃證券沒有日 K，呼叫 priceDaily 會丟 DATASET_NOT_FOUND。詳見 錯誤處理與重試。

下一步