デジタル手帳 (1.0.0)

Download OpenAPI specification:Download

認証系

管理者ログインAPI

運営者がシステムにログインするときに実行するAPI
m_admin を見に行き、ログイン情報が正しいかチェックする

Request Body schema: application/json
email
required
string (メールアドレス)
password
required
string (パスワード)

Responses

Request samples

Content type
application/json
{
  • "email": "string",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "organization_id": 1,
  • "is_organization_admin": true,
  • "is_system_admin": true
}

管理者ログイン情報取得API

ログイン者の情報を取得するAPI
m_admin を見に行き、ログイン情報を取得する

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "organization_id": 1,
  • "is_organization_admin": true,
  • "is_system_admin": true
}

会員ログインAPI

会員がシステムにログインするときに実行するAPI
m_authentication を見に行き、ログイン情報が正しいかチェックする

Request Body schema: application/json
email
required
string (メールアドレス)
password
required
string (パスワード)

Responses

Request samples

Content type
application/json
{
  • "email": "string",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "organization_id": 1,
  • "is_organization_admin": false,
  • "is_system_admin": false
}

会員ログイン情報取得API

ログイン者の情報を取得するAPI. m_member を見に行き、ログイン情報を取得する

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "organization_id": 1,
  • "is_organization_admin": false,
  • "is_system_admin": false
}

ログアウトAPI

システムからログアウトするときに実行するAPI

Responses

Response samples

Content type
application/json
{ }

団体系

団体一覧取得API

団体の一覧取得を行うAPI
運営者のみ実行可能

Responses

Response samples

Content type
application/json
{
  • "organizations": [
    ]
}

団体登録API

団体の登録を行うAPI
運営者のみ実行可能
データ登録手順として初めに m_organization にデータを登録
生成された organization_id とリクエストの fiscal_year をもとにm_fiscal_year にデータを登録(順番前後可)
生成された organization_id とリクエストの password, email をもとに m_admin にデータを登録(順番前後可)
生成された fiscal_year_id と リクエストの files をもとに m_file にデータを登録する

Request Body schema: multipart/form-data
name
required
string

団体名

code
required
string

団体識別コード

files[][file]
Array of strings

ファイル

files[][title]
string

タイトル

email
required
string

管理者用メールアドレス

password
required
string

管理者用パスワード

fiscal_yaer
required
integer

データ対象年度

Responses

Response samples

Content type
application/json
{ }

団体詳細取得API

団体の詳細取得を行うAPI
システム運営者の場合…メールアドレスとパスワードも返却
団体管理者及び会員の場合…メールアドレスとパスワードは返却しない

path Parameters
organization_id
required
integer

団体ID

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "ITCowork",
  • "files": [
    ],
  • "email": "tq5hm2_fo0qg4@hotmail.com",
  • "password": "IGzUwDb_F_Wv1G7"
}

団体更新API

団体の更新を行うAPI
運営者及び団体管理者のみ実行可能
システム運営者の場合…メールアドレス及びパスワード変更可能
団体管理者の場合…メールアドレス及びパスワード変更不可

path Parameters
organization_id
required
integer

団体ID

Request Body schema: multipart/form-data
name
required
string

団体名

code
required
string

団体識別コード

files[][file]
string <binary>

ファイル

files[][title]
string

タイトル

emai
string

メールアドレス

password
string

パスワード

Responses

Response samples

Content type
application/json
{ }

団体削除API

団体の削除を行うAPI
運営者のみ実行可能

path Parameters
organization_id
required
integer

団体ID

Responses

Response samples

Content type
application/json
{ }

団体詳細ファイル一覧取得API

団体に紐づくファイルの一覧取得を行うAPI

query Parameters
organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Response samples

Content type
application/json
{}

会員系

会員一覧取得API

団体ID 及び データ対象年度 に紐づく会員の一覧取得を行うAPI

query Parameters
organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Response samples

Content type
application/json
{
  • "members": [
    ]
}

会員登録API

会員の登録を行うAPI

Request Body schema: multipart/form-data
file
required
string <binary>

顔写真ファイル

name
required
string

会員名

name_kana
required
string

会員名(かな)

birthday
required
string <date>

誕生日

admission_year
required
string <date>

入会年

position
string or null

役職

committee_id
required
integer

委員会ID

workplace_name
required
string

勤務先名

workplace_address
required
string

勤務先住所

workplace_position
string or null

勤務先役職

workplace_phone_number
required
string

勤務先TEL

workplace_fax_number
string or null

勤務先FAX

phone_number
string

電話番号

email
required
string

メールアドレス

workplace_hp_url
string

会社ホームページURL

job_category
required
string

職種

industry_id
required
integer

業種ID

hobby
string or null

趣味

home_address
string or null

自宅住所

home_phone_number
string or null

自宅TEL

home_fax_number
string

自宅FAX

organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Response samples

Content type
application/json
{ }

会員詳細取得API

会員の詳細取得を行うAPI

path Parameters
member_id
required
integer

会員ID

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "file_name": "https;//localhost/files/yamada.png",
  • "name": "山田 太郎",
  • "name_kana": "やまだ たろう",
  • "birthday": "1998-05-10",
  • "admission_year": "2020",
  • "position": 26,
  • "committee_id": 1,
  • "workplace_name": "株式会社ほげ",
  • "workplace_address": "031-0084 青森県八戸市江陽5丁目",
  • "workplace_position": null,
  • "workplace_phone_number": "000-000-0000",
  • "workplace_fax_number": "000-000-0000",
  • "phone_number": "000-000-0000",
  • "email": "g16k2f96@gmail.com",
  • "workplace_hp_url": "https://hoge/",
  • "job_category": "シニアアプリケーション代表者",
  • "industry_id": 1,
  • "hobby": "釣り",
  • "home_address": null,
  • "home_phone_number": null,
  • "home_fax_number": null,
  • "fiscal_year": 2024
}

会員更新API

会員の更新を行うAPI

path Parameters
member_id
required
integer

会員ID

Request Body schema: multipart/form-data
file
string <binary>

顔写真ファイル

name
string

名前

name_kana
string

名前(かな)

birthday
string <date>

誕生日

admission_year
string <date>

入会年

position
string or null

役職

committee_id
integer

委員会ID

workplace_name
string

勤務先名

workplace_address
string

勤務先住所

workplace_position
string or null

勤務先役職

workplace_phone_number
string

勤務先TEL

workplace_fax_number
string or null

勤務先FAX

phone_number
string or null

電話番号

workplace_hp_url
string or null

会社ホームページURL

job_category
string

職種

industry_id
integer

業種ID

hobby
string or null

趣味

home_address
string or null

自宅住所

home_phone_number
string or null

自宅TEL

home_fax_number
string or null

自宅FAX

Responses

Response samples

Content type
application/json
{ }

会員削除API

会員の削除を行うAPI

path Parameters
member_id
required
integer

会員ID

Responses

Response samples

Content type
application/json
{ }

委員会系

委員会一覧API

団体ID に紐づく委員会の一覧取得を行うAPI

query Parameters
organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Response samples

Content type
application/json
{
  • "committees": [
    ]
}

委員会登録API

団体ID に紐づく委員会の登録を行うAPI

Request Body schema: application/json
name
required
string

委員会名

organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Request samples

Content type
application/json
{
  • "name": "南部園スクラム8",
  • "organization_id": 1,
  • "fiscal_year_id": 1
}

Response samples

Content type
application/json
{ }

委員会詳細取得API

委員会の詳細取得を行うAPI

path Parameters
committee_id
required
integer

委員会ID

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "スポーツまちおこし",
  • "fiscal_year": 2024
}

委員会更新API

委員会の更新を行うAPI

path Parameters
committee_id
required
integer

委員会ID

Request Body schema: application/json
name
required
string

委員会名

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{ }

委員会削除API

委員会の削除を行うAPI

path Parameters
committee_id
required
integer

委員会ID

Responses

Response samples

Content type
application/json
{ }

業種系

業種一覧取得API

団体ID に紐づく業種の一覧取得を行うAPI

query Parameters
organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Response samples

Content type
application/json
{
  • "industries": [
    ]
}

業種登録API

業種の登録を行うAPI

Request Body schema: application/json
name
required
string

業種名

organization_id
required
integer

団体ID

fiscal_year_id
required
integer

データ対象年度ID

Responses

Request samples

Content type
application/json
{
  • "name": "食べる",
  • "organization_id": 1,
  • "fiscal_year_id": 1
}

Response samples

Content type
application/json
{ }

業種詳細取得API

業種の詳細取得を行うAPI

path Parameters
industry_id
required
integer

業種ID

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "食べる",
  • "fiscal_year": 2024
}

業種更新API

業種の更新を行うAPI

path Parameters
industry_id
required
integer

業種ID

Request Body schema: application/json
name
required
string

業種名

Responses

Request samples

Content type
application/json
{
  • "name": "食べる"
}

Response samples

Content type
application/json
{ }

業種削除API

業種の削除を行うAPI

path Parameters
industry_id
required
integer

業種ID

Responses

Response samples

Content type
application/json
{ }

年度系

次年度データ作成API

次年度データの作成を行うAPI
リクエストされたデータ対象年度IDに紐づく会員、委員会、業種のデータをコピーして次年度データとして作成する

Request Body schema: application/json
fiscal_year_id
required
integer

データ対象年度ID

Responses

Request samples

Content type
application/json
{
  • "fiscal_year_id": 1
}

Response samples

Content type
application/json
{ }

年度一覧取得API

団体ID に紐づく年度の一覧取得を行うAPI

query Parameters
organization_id
required
integer

団体ID

Responses

Response samples

Content type
application/json
{
  • "fiscal-years": [
    ]
}