学習指導要領コード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
 curriculumStandardCode◯null値
 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の助成を受けたものです。