API DocumentationREST API で
REST API で
問題データを取得
シンプルなRESTful APIで、教育問題データベースにプログラムからアクセス。
わずか数行のコードで、高品質な問題データを取得できます。
Quick Start
3ステップで利用開始
1
APIキーを取得
お問い合わせ後、専用のAPIキーを発行します
2
リクエストを送信
HTTPリクエストでエンドポイントにアクセス
3
データを活用
JSON形式のレスポンスをアプリに組み込み
cURL リクエスト例
bashcurl -X GET \
"https://api.meta-select.com/api/v1/questions?subject=数学&grade=高校1年&per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Endpoints
主要エンドポイント
RESTful設計で直感的にアクセスできるAPI群
GET
/api/v1/questions問題一覧を取得。教科・学年・単元・問題形式などでフィルタリング可能。
パラメータ
subjectstring教科名で絞り込みgradestring学年で絞り込みunitstring単元で絞り込みquestion_typestring問題形式で絞り込みpagenumberページ番号(デフォルト: 1)per_pagenumber1ページあたりの件数(デフォルト: 20、最大: 100)GET
/api/v1/questions/:id指定したIDの問題データを1件取得。関連する画像URLやメタデータも含まれます。
GET
/api/v1/subjects利用可能な教科一覧を取得。学校種(小・中・高)でフィルタリング可能。
パラメータ
school_typestring学校種で絞り込み(elementary, junior_high, high_school)GET
/api/v1/curriculumカリキュラムツリー(教科→科目→章→節→単元)を階層構造で取得。
パラメータ
subject_idstring教科IDで絞り込みdepthnumber取得する階層の深さ(1〜6)Response
レスポンス例
構造化されたJSONで、LaTeX記法を含む問題データを取得できます
GET /api/v1/questions — 200 OK
json{
"data": [
{
"id": "q_abc123",
"management_number": "HS-MATH-001",
"question_type": "multiple_choice",
"subject": "数学",
"grade": "高校1年",
"course": "数学I",
"chapter": "数と式",
"unit": "2次方程式",
"content": "x^2 - 5x + 6 = 0 を解きなさい。",
"content_latex": "$x^2 - 5x + 6 = 0$ を解きなさい。",
"answer": "x = 2, 3",
"answer_latex": "$x = 2, 3$",
"explanation": "因数分解により ...",
"choices": [
{ "label": "A", "text": "$x = 1, 6$" },
{ "label": "B", "text": "$x = 2, 3$" },
{ "label": "C", "text": "$x = -2, -3$" },
{ "label": "D", "text": "$x = -1, -6$" }
],
"has_image": false,
"images": [],
"tags": ["因数分解", "2次方程式"],
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-02-01T14:00:00Z"
}
],
"meta": {
"total": 10234,
"page": 1,
"per_page": 20,
"total_pages": 512
}
}LaTeX記法対応
content_latex, answer_latex フィールドにLaTeX記法のテキストを含む
メタデータ付き
教科・学年・科目・章・単元の階層情報を含む
ページネーション
meta オブジェクトに総件数・ページ情報を含む
画像URL対応
images 配列に署名付きURLを含む
Security
認証・セキュリティ
APIキー認証
お客様ごとに発行されるAPIキーで認証。Authorizationヘッダーに Bearer トークンとして付与します。
HTTPS暗号化
すべての通信はHTTPS(TLS 1.2以上)で暗号化。データの安全な送受信を保証します。
レートリミット
1分あたり60リクエスト(標準プラン)。高頻度アクセスが必要な場合はカスタムプランをご相談ください。
利用状況モニタリング
APIの利用回数・レスポンスタイムをダッシュボードで確認可能。異常検知時はアラート通知します。
Error Codes
ステータスコード一覧
| コード | ステータス | 説明 |
|---|---|---|
| 200 | OK | 正常に処理されました |
| 400 | Bad Request | リクエストパラメータに誤りがあります |
| 401 | Unauthorized | APIキーが無効または未設定です |
| 403 | Forbidden | アクセス権限がありません |
| 404 | Not Found | 指定されたリソースが見つかりません |
| 429 | Too Many Requests | レートリミットを超えています |
| 500 | Internal Server Error | サーバー内部エラーが発生しました |
