学習指導要領コードAPI

学習指導要領コードAPIについて

学習指導要領コードAPIは、東京学芸大学教育コンテンツアーカイブに登録されている学習指導要領コードが付与された資料の一覧を取得できるAPIです。

利用できる方

営利を目的としない(データを利用することにより、経済的な対価を一切受け取らない)場合に限り、利用申請等の手続きなく、どなたでもご利用いただけます。

留意事項

ご利用にあたっては以下の点にご留意ください。

  • 本APIを利用するサイトやアプリケーションには、東京学芸大学教育コンテンツアーカイブのAPIを用いていることを明示してください。
  • 継続的にアクセスを行われる場合には、API利用実態の把握のために、以下までご連絡先、ご利用内容等をお知らせくださいますよう、ご協力をお願いします。

    東京学芸大学附属図書館 アーカイブ係
    Tel:042-329-7896
    Mail:archives(a)u-gakugei.ac.jp ※(a)を@に置き換えてください。

 

API仕様

エンドポイント

  •  /json 検索結果を20件単位でjson出力する
  • /csv 検索結果の全件をcsv出力する

パラメータ説明

引数名説明
cscode

学習指導要領コードを指定。前方一致で検索される。
指定しない場合、学習指導要領コードがある全てのデータが出力される。


(例)
学習指導要領コードの完全一致
/json?cscode=82802C5310000000
/csv?cscode=82802C5310000000


学習指導要領コードの前方一致
/csv?cscode=82 (小学校の学習指導要領での検索)
/json?cscode=821(小学校の国語教科での検索)

lastUpdate

引数は、データの更新日時を基準に出力結果を絞り込む。指定した日付以降のデータを抽出。この引数を省略すると、すべてのデータが出力される。
日付の形式は、年月日、または年月日時分秒の形式
yyyy-mm-dd の年月日
yyyy-mm-dd hh:mm:ss 年月日時分秒 (途中半角スペースで区切る)


(例)
/json?lastUpdate=2024-11-19 09:00:00
/csv?lastUpdate=2024-11-19

page/json の場合に動作する
ページを指定する。0 ページから始まる。

(例)
/json?page=2
items_per_page/json の場合に動作する
10, 20, 50が指定が可能。既定値は、20。

(例)
/json?items_per_page=50

 

出力サンプル

CSV仕様

  • ヘッダ行:あり
  • 区切り文字:カンマ区切り
  • 改行コード:LF
  • 囲み文字:基本なし。
    ただし、値の途中にカンマがあれば、(”) ダブルコーテーションで括る
  • UTF-8 (BOMなし)の形式

CSV出力

呼び出し例l: https://d-archive.u-gakugei.ac.jp/csv?cscode=83212A5240000000

idtitlecurriculum
StandardC
ode
providerdateUpdat
ed
thumbnailU
rl
itemUrl
13435家庭教育世
界一周すご
ろく
83212A524
0000000
東京学芸大学2024-10-31
T14:42:28+
09:00
https://d-arc
hive.u-gaku
https://d-arc
hive.u-gaku
gei.ac.jp/iiif/
2/library%2
52F185058
36%252F00
01.tif/full/22
0,/0/default.
https://d-arc
hive.u-gaku
gei.ac.jp/ite
m/1850583
6

JSON仕様

第1階層第2階層必須内容
page ページ数
0始まり
counts 検索結果件数
totalPages ページ数
perPage 1ページあたりの件数
queryData  
 uri検索URL
 curriculumStandardCodenull値
 upperCurriculumStandardCo
de
null値
 lowerCurriculumStandardCo
de
null値
rows 配列
 id 資料のID
Drupalのnid
 title 資料のタイトル
 curriculumStandardCode 資料の学習指導要領コード
 provider “東京学芸大学”の値をセット
 dateUpdated 資料の更新日時
 thumbnailUrl 資料のサムネイル画像URL
 itemUrl 資料のURL

JSON出力

呼び出し例: https://d-archive.u-gakugei.ac.jp/json?cscode=82L&lastUpdate=2024-07-01

{
"page":0,
"counts":"1",
"totalPages":1,
"perPage":20,
"queryData":{"uri":"https://d-archive.u-gakugei.ac.jp/json?cscode=82L&lastUpdate=2024-
07-01",
"curriculumStandardCode":null,
"upperCurriculumStandardCode":null,
"lowerCurriculumStandardCode":null},
"rows":[{"id":"18069",
"title":"地域の音楽を楽しもう-民謡から考える地域の文化と継承-",
"curriculumStandardCode":"82802C5310000000,8280300241000000,8290300280000000,82L12C322
2113000,82M03L0270000000,8220243421000000,8220243411000000,82K0300270000000",
"provider":"東京学芸大学",
"dateUpdated":"2024-08-07T16:26:48+09:00",
"thumbnailUrl":"https://d-archive.u-gakugei.ac.jp/iiif/2/library%252Fexws-09%252F00001
.tif/full/220,/0/default.jpg",
"itemUrl":"https://d-archive.u-gakugei.ac.jp/item/exws-09"}]
}

 

免責事項

  • 本APIの提供は、教育・研究活動の支援を目的とするものであり、動作の完全性・正確性を保証するものではありません。
  • APIの利用により利用者が被ったいかなる損害についても、東京学芸大学は一切の責任を負いません。
  • 本APIの仕様は予告なく変更または停止される場合があります。
  • 利用者は、取得したデータの利用にあたり、著作権その他の権利に十分留意し、自己の責任において活用してください。

 

本API開発は、JSPS科研費 JP24K00366の助成を受けたものです。