1、查詢機(jī)構(gòu)、學(xué)校列表清單

基礎(chǔ) 需要授權(quán)

根據(jù)各種條件查詢機(jī)構(gòu)、學(xué)校等組織

前置條件

獲取接口訪問憑證：accessToken

請求說明

url	https://api.hfeducloud.cn/user/openapi/org/query-org?accessToken=ACCESS_TOKEN
請求方式	post
是否需要鑒權(quán)	是
請求數(shù)限制	否
接口方向	第三方應(yīng)用->開放平臺

參數(shù)說明

序號	字段名	約束	類型	說明
1	org_id	可選	String	機(jī)構(gòu)、學(xué)校等組織id
2	org_name	可選	String	機(jī)構(gòu)、學(xué)校等組織名稱
3	org_type	可選	String	組織類型，多個使用英文逗號分隔(1機(jī)構(gòu)，2學(xué)校，8企業(yè)，9教學(xué)工作室，10平臺)
4	province_code	可選	String	所屬地理省份
5	city_code	可選	String	所屬地理市
6	area_code	可選	String	所屬地理區(qū)
7	status	可選	String	狀態(tài),多個使用英文逗號分隔(0:組織未激活,1:正常,2注銷)默認(rèn)不限
8	platform_code	可選	String	實(shí)體平臺編碼
9	v_platform_code	可選	String	虛擬平臺編碼
10	certification	可選	String	認(rèn)證(0:未認(rèn)證,1:已認(rèn)證)
11	org_category	可選	String	組織的類別(每個類型的組織都有自己的小類別)
12	org_level_code	可選	String	行政區(qū)劃(行政上所屬的區(qū)域)
13	org_parent_id	可選	String	上級機(jī)構(gòu)id(查的是直屬下級單位)
14	org_parent_ids	可選	String	附屬上級機(jī)構(gòu)id(查的是所有的下級單位，包括跨行政級別的下級單位組織)
15	flag	可選	String	標(biāo)記,多個使用英文逗號分隔,默認(rèn)正常和演示(0:正常,1:演示,2:測試)
16	org_record_status	可選	String	教育局備案狀態(tài),0:未備案，1：已備案
17	page	可選	Int	查詢頁
18	page_size	可選	Int	查詢條數(shù)，默認(rèn)10，上限100
19	sort	可選	string	默認(rèn)為空，傳time : 創(chuàng)建時間倒序

返回說明

序號	字段名	約束	類型	說明
1	code	必選	string	結(jié)果編碼,000000：成功, 100001：失敗
2	message	必選	string	結(jié)果描述
3	result	必選	json[]	json數(shù)組
3.1	page	必選	int	當(dāng)前頁
3.2	page_size	必選	int	查詢量
3.3	count	必選	int	總數(shù)
3.4	lists	必選	array	數(shù)組對象
3.4.1	org_id	必選	string	組織id
3.4.2	org_name	必選	string	組織名稱
3.4.3	org_type	必選	string	組織類型

示例

							請求示例
https://api.hfeducloud.cn/user/openapi/org/query-org?accessToken=ACCESS_TOKEN
{
   "org_name" : "小學(xué)",
   "org_type":"2",
   "org_category":"0"
}
返回示例
{
  "code": "000000",
  "message": "成功",
  "result": {
    "page": 1,
    "page_size": 10,
    "count": 2,
    "lists": [
      {
        "org_id": "dde57a52919d11e9b8620200f766f6f0",
        "org_name": "武漢市電教中心",
        "org_type": 1
      },
      {
        "org_id": "34e6b70e8c4311e9bc3b0200f70dd853",
        "org_name": "武漢市教育局",
        "org_type": 1
      }
    ]
  }
}

序號	字段名	約束	類型	長度	說明
1	msgType	必選	String	10	消息類型，此時固定為：text
1.1	text	必選	Json	-	text消息體
1.1.1	content	必選	String		消息內(nèi)容

參數(shù)說明

請求參數(shù)消息體-link類

序號	字段名	約束	類型	長度	說明
1	msgType	必選	String	10	消息類型，此時固定為：link
2	link	必選	Json	-	link消息體
2.1	pcUrl	必選	String		PC端消息點(diǎn)擊鏈接地址
2.2	appUrl	必選	String		移動客戶端點(diǎn)擊消息時跳轉(zhuǎn)到的H5地址
2.3	title	必選	String		消息標(biāo)題
2.4	busiId	必選	String		對應(yīng)業(yè)務(wù)的id
2.5	content	必選	String		消息描述
2.6	picUrl	必選	String		圖文消息的圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640320，小圖8080。如不填，在客戶端不顯示圖片

示例

{
	"msgtype": "link",
	"link": {
		"pcUrl": "http://www.baidu.com",
		"appUrl": "http://www.baidu.com",
		"picUrl": "http://xxx.yyy.com/zzz.jpg",
		"content": "百度一下",
		"title": "百度",
		"busiId":"AQWER1234"
	}
}

參數(shù)說明

請求參數(shù)消息體-oa類

序號	字段名	約束	類型	長度	說明
1	msgType	必選	String	10	消息類型，此時固定為：oa
2	busiId	必選	String	-	該條oa消息在業(yè)務(wù)系統(tǒng)對應(yīng)的id
3	pcUrl	必選	String		消息點(diǎn)擊鏈接地址
4	appUrl	必選	String		移動客戶端點(diǎn)擊消息時跳轉(zhuǎn)到的H5地址
5	oa	必選	Json	-	oa類型消息體
5.1	head	必選	Json	255	消息頭部Json
5.1.1	text	必選	String	255	消息的頭部標(biāo)題
5.1.2	bgColor	可選	String		消息頭部的背景顏色。長度限制為8個英文字符，其中前2為表示透明度，后6位表示顏色值。不要添加0x。默認(rèn)值：FFCC0000
5.2	body	可選	Json		消息體
5.2.1	title	可選	String		消息體的標(biāo)題
5.2.2	content	可選	String		消息體的正文
5.2.3	imageUrl	可選	String		消息體中的圖片url
5.2.4	fileCount	可選	String		自定義的附件數(shù)目。此數(shù)字僅供顯示，不作驗(yàn)證
5.2.5	author	可選	String		自定義的作者名字
5.2.6	form	可選	Json數(shù)組		消息體的表單，最多6個
5.2.7	key	可選	String		消息體的關(guān)鍵字
5.2.8	value	可選	String		消息體的關(guān)鍵字對應(yīng)的值

開發(fā)者登錄

1、查詢機(jī)構(gòu)、學(xué)校列表清單

前置條件

請求說明

參數(shù)說明

返回說明

示例

參數(shù)說明

示例

參數(shù)說明

示例

參數(shù)說明

空間登錄

手機(jī)掃碼，安全登錄

手機(jī)掃碼，安全登錄

開發(fā)者登錄

1、查詢機(jī)構(gòu)、學(xué)校列表清單

前置條件

請求說明

參數(shù)說明

返回說明

示例

參數(shù)說明

示例

參數(shù)說明

示例

參數(shù)說明

空間登錄

手機(jī)掃碼，安全登錄

手機(jī)掃碼，安全登錄

1、查詢機(jī)構(gòu)、學(xué)校列表清單

手機(jī)掃碼，安全登錄