> ## 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議事録を取得。TypeScript、Python、Java、Goのコードサンプルを掲載。
export const FeedbackJa = () => <>
このフィーチャーへのご意見やご要望は、Product Feedback からチームへお送りください。
公式リンク
公式ウェブサイトはこちら
Xでフォロー
Facebookでいいね
LinkedInでつながる
;
## バックエンドから VoicePing 議事録を取得
API Accessは、サーバー同士のワークフロー ― 定期エクスポート、CRM同期、ダッシュボード、コンプライアンスアーカイブなど ― のためのアクセス方式です。ワークスペースでAPIキーを発行し、スコープを付与して、バックエンドから標準のBearerトークンでVoicePing APIを呼び出します。
**人間** がAIクライアント経由で質問する場合は、代わりに [MCP Access](/ja/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キーを発行する
1. **ワークスペース設定 → 外部アクセス → API Access** を開く。
2. **API Access Mode** がオフの場合は有効化する。
3. **Create API key** をクリックする。
4. 名称、**許可IPアドレス**（推奨）、必要な **スコープ**、有効期間を選択する。
5. 発行されたキーをその場でコピーし、シークレットマネージャーに保管する。キー全文が表示されるのはこの一度のみです。
After the key is created, VoicePing shows the raw key only once. Copy it before dismissing the success panel.
**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を呼び出す
同じ2ステップのフロー ― **議事録を検索し、1件を取得する** ― を4言語で示します。TypeScriptを最初に表示しています。利用技術スタックに合わせてタブを切り替えてください。
```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などAIクライアントから質問する場合は、MCP Accessをご利用ください。