HOME ガイド ニュース ダウンロード サインイン 始める
Glasscloudトップガイド一覧GlassQkan LのAPIの仕様について

■GlassQkan LのAPIの仕様について



ここでは、GlassQkan LのAPIの仕様について紹介いたします。

GlassQkan Lでは、システム連携用にAPIを用意しています。
使用する際には、カスタマセンターに予めご連絡ください。




◆患者情報をGlasssQkan Lに追加するAPI

API宛先例
https://××××××××××××××/gqlapi?acttype=GQLAPIINSERT


以下の形式をjsonデータで、POSTで送信してください。

			{"patient_code”:"1001234",
			"patient_family_name":"田中",
			"patient_first_name":"てすと",
			"patient_family_kana":"タナカ",
			"patient_first_kana":"テスト",
			"patient_sex":1,
			"patient_birthday":"1990-01-01",
			"patient_tel_first":"080",
			"patient_tel_second":"1234",
			"patient_tel_third":"5678",
			"patient_zip_first":"123",
			"patient_zip_second":"4567",
			"patient_address":"東京都渋谷区広尾 1-2-3"
			}
			

			{"patient_code”:"1001234",→文字列 GQLで利用者コードとなるもの。任意に指定してください。
			"patient_family_name":"田中",→文字列 利用者姓日本語全角
			"patient_first_name":"てすと",→文字列 利用者名日本語全角
			"patient_family_kana":"タナカ",→文字列 利用者姓日本語カタカナ
			"patient_first_kana":"タロウ",→文字列 利用者名日本語カタカナ
			"patient_sex":0,→数値 性別 男 1 女 2
			"patient_birthday":"1990-01-01",→文字列 生年月日 YYYY-MM-DD
			"patient_tel_first":"080",→文字列 電話番号前
			"patient_tel_second":"1234",→文字列 電話番号中
			"patient_tel_third":"5678",→文字列 電話番号後
			"patient_zip_first":"123",→文字列 郵便番号前
			"patient_zip_second":"4567",→文字列 郵便番号後
			"patient_address":"東京都渋谷区広尾1-2-3"→文字列 住所
			}
			
レスポンスは以下のjsonデータで送られてきます。

			・成功
			{
			"status": "success",
			"code": 200,
			"patient_code": "1001234",
			}
			

			・失敗
			{
			"status": "failure",
			"code": 400,
			"patient_code": "1001234",
			}
			
◆患者情報をGQL(GlasssQkan L)に更新するAPI

API宛先例
https://××××××××××××××/gqlapi?acttype=GQLAPIUPDATE

以下の形式をjsonデータで、POSTで送信してください。

			{"patient_code”:"1001234",
			"patient_family_name":"田中",
			"patient_first_name":"てすと",
			"patient_family_kana":"タナカ",
			"patient_first_kana":"テスト",
			"patient_sex":1,
			"patient_birthday":"1990-01-01",
			"patient_tel_first":"080",
			"patient_tel_second":"1234",
			"patient_tel_third":"5678",
			"patient_zip_first":"123",
			"patient_zip_second":"4567",
			"patient_address":"東京都渋谷区広尾 1-2-3"
			}
			

			{"patient_code”:"1001234",→文字列 GQLで利用者コードとなるもの。これが主キーとなり、更新を行う。
			"patient_family_name":"田中",→文字列 利用者姓日本語全角
			"patient_first_name":"てすと",→文字列 利用者名日本語全角
			"patient_family_kana":"タナカ",→文字列 利用者姓日本語カタカナ
			"patient_first_kana":"タロウ",→文字列 利用者名日本語カタカナ
			"patient_sex":0,→数値 性別 男 1 女 2
			"patient_birthday":"1990-01-01",→文字列 生年月日 YYYY-MM-DD
			"patient_tel_first":"080",→文字列 電話番号前
			"patient_tel_second":"1234",→文字列 電話番号中
			"patient_tel_third":"5678",→文字列 電話番号後
			"patient_zip_first":"123",→文字列 郵便番号前
			"patient_zip_second":"4567",→文字列 郵便番号後
			"patient_address":"東京都渋谷区広尾1-2-3"→文字列 住所
			}
			
レスポンスは以下のjsonデータで送られてきます。

			成功
			{
			"status": "success",
			"code": 200,
			"patient_code": "1001234",
			}
			

			失敗
			{
			"status": "failure",
			"code": 400,
			"patient_code": "1001234",
			}
			
◆利用者情報を全件参照するAPI

API宛先例
https://××××××××××××××/gqlapi?acttype=GQLAPIPTSELECT

レスポンスは以下のjsonデータとなります。

			[{"patient_birthday":"1950-01-01",
			"patient_first_kana":"テスト",
			"patient_tel_third":"5678",
			"show_flag":0,
			"patient_family_kana":"タナカ",
			"ptid":0,"patient_address":"東京都渋谷区広尾1-2-3",
			"patient_first_name":"テスト",
			"patient_family_name":"田中",
			"patient_tel_second":"1234",
			"patient_sex":2,
			"patient_tel_first":"090",
			"patient_id":2701,
			"last_time":"2025-01-09 17:33:57.0",
			"patient_zip_first":"123",
			"hospnum":0,
			"delete_flag":0,
			"patient_zip_second":"4567",
			"patient_code":"00001"
			},
			{"patient_birthday":"1950-02-01",
			"patient_first_kana":"テスト",
			"patient_tel_third":"5678",
			"show_flag":0,"patient_family_kana":"ヤマダ",
			"ptid":0,"patient_address":"東京都渋谷区広尾1-2-4",
			"patient_first_name":"テスト",
			"patient_family_name":"山田",
			"patient_tel_second":"1234",
			"patient_sex":2,"patient_tel_first":"080",
			"patient_id":2702,
			"last_time":"2025-01-09 17:33:57.0",
			"patient_zip_first":"123",
			"hospnum":0,
			"delete_flag":0,
			"patient_zip_second":"4567",
			"patient_code":"00002"
			}]
			
参照結果が0件の場合は、以下の空のjsonデータが送られます。
			[]
			
◆利用者情報を1件参照するAPI

API宛先例
https://××××××××××××××/gqlapi?acttype=GQLAPIPTSELECT&patient_code=XXXXX

レスポンスは以下のjsonデータとなります。

			[{"patient_birthday":"1950-01-01",
			"patient_first_kana":"テスト",
			"patient_tel_third":"5678",
			"show_flag":0,
			"patient_family_kana":"タナカ",
			"ptid":0,
			"patient_address":"東京都渋谷区広尾1-2-3",
			"patient_first_name":"テスト",
			"patient_family_name":"田中",
			"patient_tel_second":"4567",
			"patient_sex":2,
			"patient_tel_first":"090",
			"patient_id":2703,
			"last_time":"2025-01-09 17:33:57.0",
			"patient_zip_first":"123",
			"hospnum":0,"delete_flag":0,
			"patient_zip_second":"4567",
			"patient_code":"05624"
			}
			
参照結果が0件の場合は、以下の空のjsonデータが送られます。
			[]
			
◆利用者の対象月の単位数と請求額を1件参照するAPI

API宛先例
https://××××××××××××××/gqlapi?acttype=GQLAPIPTCLAIMSELECT&&patient_code=XXXXX&&yyyymm=XXXX-XX

レスポンスは以下のjsonデータとなります。

			成功
			{
			"patient_code":"05624",→利用者番号
			"unitamount":"574",→対象月の合計単位数 
			"billamount":"1722"→対象月の利用者請求額 
			}
			指定した利用月に請求データがない場合は以下のようになります。
			{
			"patient_code":"05624",
			"unitamount":"no data",
			"billamount":"no data"
			}
			

			失 敗
			{
			"status": "failure",
			"code": 400,
			"patient_code": "1001234",
			}
			
[作成日 2026/03/19]