API Documentation

REST API
問題データを取得

シンプルなRESTful APIで、教育問題データベースにプログラムからアクセス。わずか数行のコードで、高品質な問題データを取得できます。

Quick Start

3ステップで利用開始

1

APIキーを取得

お問い合わせ後、専用のAPIキーを発行します

2

リクエストを送信

HTTPリクエストでエンドポイントにアクセス

3

データを活用

JSON形式のレスポンスをアプリに組み込み

cURL リクエスト例
bash
curl -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

ステータスコード一覧

コードステータス説明
200OK正常に処理されました
400Bad Requestリクエストパラメータに誤りがあります
401UnauthorizedAPIキーが無効または未設定です
403Forbiddenアクセス権限がありません
404Not Found指定されたリソースが見つかりません
429Too Many Requestsレートリミットを超えています
500Internal Server Errorサーバー内部エラーが発生しました

APIキーを取得して
今すぐ始めましょう

お問い合わせいただければ、APIキーとサンプルデータを無料でご提供します。