API 存取

// Requires Node.js 18+ (for built-in fetch)
const apiKey = process.env.VOICEPING_API_KEY!;
const base = "https://api.voiceping.io/api/v1";
const headers = { Authorization: `Bearer ${apiKey}` };

// 1. Search transcripts
const searchRes = await fetch(
  `${base}/transcripts/search?q=pricing&limit=10`,
  { headers },
);
const { transcripts } = await searchRes.json();

// 2. Read the first result in full
const detailRes = await fetch(
  `${base}/transcripts/${transcripts[0].id}`,
  { headers },
);
const transcript = await detailRes.json();

console.log(transcript.title, transcript.content);

# pip install requests
import os
import requests

api_key = os.environ["VOICEPING_API_KEY"]
base = "https://api.voiceping.io/api/v1"
headers = {"Authorization": f"Bearer {api_key}"}

# 1. 搜尋逐字稿
search = requests.get(
    f"{base}/transcripts/search",
    headers=headers,
    params={"q": "pricing", "limit": 10},
).json()

# 2. 讀取第一筆完整結果
first_id = search["transcripts"][0]["id"]
detail = requests.get(
    f"{base}/transcripts/{first_id}",
    headers=headers,
).json()

print(detail["title"], detail["content"])

// Java 11+ (uses built-in java.net.http)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class VoicePingQuickstart {
    public static void main(String[] args) throws Exception {
        String apiKey = System.getenv("VOICEPING_API_KEY");
        String base = "https://api.voiceping.io/api/v1";
        HttpClient client = HttpClient.newHttpClient();

        // 1. 搜尋逐字稿
        HttpRequest search = HttpRequest.newBuilder()
            .uri(URI.create(base + "/transcripts/search?q=pricing&limit=10"))
            .header("Authorization", "Bearer " + apiKey)
            .GET()
            .build();
        HttpResponse<String> searchRes =
            client.send(search, HttpResponse.BodyHandlers.ofString());
        System.out.println(searchRes.body());

        // 2. 讀取逐字稿（先從 searchRes.body() 解析 id，
        //    再以實際值取代下方的 TRANSCRIPT_ID）
        HttpRequest detail = HttpRequest.newBuilder()
            .uri(URI.create(base + "/transcripts/TRANSCRIPT_ID"))
            .header("Authorization", "Bearer " + apiKey)
            .GET()
            .build();
        HttpResponse<String> detailRes =
            client.send(detail, HttpResponse.BodyHandlers.ofString());
        System.out.println(detailRes.body());
    }
}

// go run main.go
package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    apiKey := os.Getenv("VOICEPING_API_KEY")
    base := "https://api.voiceping.io/api/v1"

    // 1. Search transcripts
    req, _ := http.NewRequest("GET",
        base+"/transcripts/search?q=pricing&limit=10", nil)
    req.Header.Set("Authorization", "Bearer "+apiKey)

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))

    // 2. Read a transcript by id (parse id from body first)
    detailReq, _ := http.NewRequest("GET",
        base+"/transcripts/TRANSCRIPT_ID", nil)
    detailReq.Header.Set("Authorization", "Bearer "+apiKey)

    detailRes, _ := http.DefaultClient.Do(detailReq)
    defer detailRes.Body.Close()
    detailBody, _ := io.ReadAll(detailRes.Body)
    fmt.Println(string(detailBody))
}