> ## Documentation Index
> Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt
> Use this file to discover all available pages before exploring further.
# API Access
> สอบถามบันทึกการประชุมของ VoicePing จากแบ็กเอนด์ของคุณเองด้วย API key ที่กำหนดขอบเขต พร้อมตัวอย่างโค้ดใน TypeScript, Python, Java และ Go
export const FeedbackTh = () => <>
มีไอเดียหรือคำขอเกี่ยวกับฟีเจอร์นี้ไหม? ส่งถึงทีมผ่าน Product Feedback
ลิงก์อย่างเป็นทางการ
เยี่ยมชมเว็บไซต์อย่างเป็นทางการของเรา
ติดตามเราบน X
ติดตามเราบน Facebook
เชื่อมต่อบน LinkedIn
;
## สอบถามบันทึก VoicePing จากแบ็กเอนด์ของคุณ
API Access มีไว้สำหรับเวิร์กโฟลว์ระหว่างเซิร์ฟเวอร์ — การส่งออกตามตารางเวลา การซิงก์ CRM แดชบอร์ด คลังข้อมูลเพื่อการปฏิบัติตามกฎ คุณสร้าง API key ใน workspace กำหนดขอบเขตให้มัน และแบ็กเอนด์ของคุณเรียก VoicePing API ด้วย bearer token มาตรฐาน
หาก **คน** กำลังถามคำถามผ่านไคลเอนต์ AI ให้ใช้ [MCP Access](/th/external-access/mcp) แทน
```text theme={null}
If a person is asking questions, use MCP Access.
If a server is fetching data, use API Access.
```
***
## เมื่อใดจึงใช้ API Access
| กรณีการใช้งาน | ตัวอย่าง |
| ------------------------------ | ------------------------------------------------ |
| ส่งออกตามตารางเวลา | ส่งออกบันทึกของสัปดาห์นี้ทุกวันศุกร์ |
| รายงานภายใน | สร้างรายงานสรุปการประชุมรายสัปดาห์ |
| เวิร์กโฟลว์ CRM หรือ PM | ส่งสรุปบันทึกการประชุมเข้า Salesforce หรือ Asana |
| คลังข้อมูลเพื่อการปฏิบัติตามกฎ | เก็บบันทึกการประชุมในที่จัดเก็บที่ได้รับอนุมัติ |
| แดชบอร์ด | ป้อนเมตาดาต้าของบันทึกเข้าสู่ระบบวิเคราะห์ |
***
## สร้าง API key
1. เปิด **workspace settings → External Access → API Access**
2. เปิด **API Access Mode** หากยังไม่เปิด
3. คลิก **Create API key**
4. เลือกชื่อ **ที่อยู่ IP ที่อนุญาต** (แนะนำ) **ขอบเขต** ที่ key ต้องการ และระยะเวลาที่ใช้งานได้
5. คัดลอก key ที่สร้างขึ้นทันทีและเก็บไว้ใน secret manager ของคุณ key เต็มจะแสดงเพียงครั้งเดียว
After the key is created, VoicePing shows the raw key only once. Copy it before dismissing the success panel.
**อย่า commit API key ลงไปใน repo เด็ดขาด** เก็บไว้ในตัวแปรสภาพแวดล้อมหรือ secret manager เพื่อความปลอดภัยเพิ่มเติม ล็อกแต่ละ key กับ **ที่อยู่ IP ที่อนุญาต** ที่เจาะจงในโมดัลสร้าง key — คำขอใดๆ จาก IP อื่นจะถูกปฏิเสธแม้ว่า key จะรั่วไหล
***
## ยืนยันคำขอ
ทุกคำขอยืนยันด้วย bearer token ไปที่ `https://api.voiceping.io`:
```http theme={null}
GET /api/v1/transcripts/search?q=pricing&limit=10 HTTP/1.1
Host: api.voiceping.io
Authorization: Bearer
```
ตั้งค่า key ครั้งเดียวเป็นตัวแปรสภาพแวดล้อม `VOICEPING_API_KEY` และตัวอย่างด้านล่างจะดึงมาใช้โดยอัตโนมัติ
***
## Quickstart — เรียก API ในภาษาของคุณ
ขั้นตอน 2 ขั้นตอนเดียวกัน — **ค้นหาบันทึก จากนั้นดึงหนึ่งรายการ** — ใน 4 ภาษา TypeScript แสดงก่อน สลับแท็บไปยัง stack ของคุณ
```typescript TypeScript theme={null}
// 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);
```
```python Python theme={null}
# 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 transcripts
search = requests.get(
f"{base}/transcripts/search",
headers=headers,
params={"q": "pricing", "limit": 10},
).json()
# 2. Read the first result in full
first_id = search["transcripts"][0]["id"]
detail = requests.get(
f"{base}/transcripts/{first_id}",
headers=headers,
).json()
print(detail["title"], detail["content"])
```
```java Java theme={null}
// 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. Search transcripts
HttpRequest search = HttpRequest.newBuilder()
.uri(URI.create(base + "/transcripts/search?q=pricing&limit=10"))
.header("Authorization", "Bearer " + apiKey)
.GET()
.build();
HttpResponse searchRes =
client.send(search, HttpResponse.BodyHandlers.ofString());
System.out.println(searchRes.body());
// 2. Read a transcript (parse the id from searchRes.body() first;
// shown here with a placeholder)
HttpRequest detail = HttpRequest.newBuilder()
.uri(URI.create(base + "/transcripts/TRANSCRIPT_ID"))
.header("Authorization", "Bearer " + apiKey)
.GET()
.build();
HttpResponse detailRes =
client.send(detail, HttpResponse.BodyHandlers.ofString());
System.out.println(detailRes.body());
}
}
```
```go Go theme={null}
// 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))
}
```
***
## ขั้นตอนถัดไป
กลับไปดูขอบเขต การควบคุมวงจรชีวิต และบันทึกเหตุการณ์ที่ใช้กับทั้ง MCP และ API
หากมีคนกำลังถามคำถามผ่าน Claude, ChatGPT, Codex, Claude Code หรือ Gemini CLI ใช้ MCP Access แทน