> ## 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
> 権限範囲を設定したAPIキーで、自社バックエンドからVoicePingの議事録を取得する方法
export const FeedbackJa = () => <>
この機能へのご意見・ご要望は、Product Feedbackからお寄せください。
公式リンク
VoicePing公式サイト
VoicePing公式X
VoicePing公式Facebook
VoicePing公式LinkedIn
;
## バックエンドからVoicePingの議事録を取得する
API Accessは、定期エクスポート、CRM同期、ダッシュボード、コンプライアンス対応の保管など、サーバー間連携に使います。ワークスペースでAPIキーを発行して権限範囲を設定し、バックエンドからBearerトークンでVoicePing APIを呼び出します。
AIクライアントから議事録について質問する場合は、[MCP Access](/ja/external-access/mcp)を利用してください。
***
## API Accessの主な用途
| ユースケース | 例 |
| ------------- | ------------------------- |
| 定期エクスポート | 毎週金曜に今週分の議事録を出力 |
| 社内レポート | 週次の会議サマリーレポートを作成 |
| CRM／PM連携 | 議事録要約をSalesforceやAsanaへ連携 |
| コンプライアンスアーカイブ | 指定ストレージに会議記録を保存 |
| ダッシュボード | 議事録メタデータを分析基盤へ投入 |
***
## APIキーを発行する
1. **ワークスペース設定 → 外部アクセス → API Access**を開きます。
2. **API Access Mode**がオフの場合は、有効にします。
3. **Create API key**をクリックします。
4. 名前、**許可IPアドレス**（推奨）、必要な**スコープ**、有効期間を設定します。
5. 発行されたキーをコピーし、シークレットマネージャーに保存します。キー全文を確認できるのはこのときだけです。
発行したキーの全文が表示されるのは一度だけです。完了画面を閉じる前にコピーしてください。
**APIキーをリポジトリへコミットしないでください。**環境変数またはシークレットマネージャーに保存します。キーごとに**許可IPアドレス**を設定すると、許可していないIPからのリクエストを拒否できます。
***
## リクエストの認証
すべてのリクエストは、Bearerトークンを使って`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
```
キーを環境変数`VOICEPING_API_KEY`に設定すると、次のサンプルから参照できます。
***
## クイックスタート — 各言語でAPIを呼び出す
**議事録を検索し、1件の詳細を取得する**処理を4言語で示します。利用する技術に合わせてタブを切り替えてください。
```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に共通するスコープ、アクセス管理、イベントログを確認します。
AIクライアントから議事録を参照する手順を確認します。