Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/51offer-ngdiyselectschool-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: 51offer Horizon Site Ngdiyselectschool API
version: '1.0'
summary: 51offer official-site (www.51offer.com) JSON API surface
description: Machine-readable description of the public JSON API surface of 51offer's official study-abroad site (www.51offer.com).
contact:
name: 51offer
email: woodrow.w@51offer.com
url: https://www.51offer.com/
x-provenance:
converted-from: Swagger 1.2
source: https://www.51offer.com/api-docs
fetched: '2026-09-05'
servers:
- url: https://www.51offer.com
description: '51offer official site API host. Verified live 2026-09-05: GET /ngGpaCalc/constants returned HTTP 200 application/json.'
- url: https://m.51offer.com
description: 51offer mobile-site host. Serves the same Swagger 1.2 documents at /api-docs (HTTP 200, application/json, 2026-09-05).
tags:
- name: ngdiyselectschool
description: Diy选校控制器前置
paths:
/ngdiyselectschool/addCart:
get:
operationId: addCart
tags:
- ngdiyselectschool
summary: 添加意向单
parameters:
- name: uid
in: query
required: false
schema:
type: integer
format: int32
description: 用户uid
- name: applyCountryId
in: query
required: true
schema:
type: integer
format: int32
description: 申请国家
- name: applyEducationId
in: query
required: true
schema:
type: integer
format: int32
description: 申请学历
- name: schoolId
in: query
required: true
schema:
type: integer
format: int32
description: 学校 id
- name: categoryId
in: query
required: false
schema:
type: integer
format: int32
description: 档次
- name: isRecommend
in: query
required: false
schema:
type: integer
format: int32
description: 是否为推荐学校
- name: majorId
in: query
required: false
schema:
type: integer
format: int32
description: 专业
- name: couresId
in: query
required: false
schema:
type: integer
format: int32
description: 课程 （预科）
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/checkDiyUserType:
get:
operationId: ngdiyselectschool_checkDiyUserType_2
tags:
- ngdiyselectschool
summary: diy用户成单类型分类
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_Map_string_object_5812ac'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/confirmIntentions:
get:
operationId: confirmIntentions
tags:
- ngdiyselectschool
summary: 确认意向申请单
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
- name: id
in: query
required: true
schema:
type: integer
format: int32
- name: countryId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/deleteCartMajor:
get:
operationId: deleteCartMajor
tags:
- ngdiyselectschool
summary: 删除意向专业（两种方式：1.、根据id删除。 2、根据degreeId,schoolId,majorId删除）
parameters:
- name: id
in: query
required: false
schema:
type: integer
format: int32
- name: degreeId
in: query
required: false
schema:
type: integer
format: int32
- name: schoolId
in: query
required: false
schema:
type: integer
format: int32
- name: majorId
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/deleteCartSchool:
get:
operationId: deleteCartSchool
tags:
- ngdiyselectschool
summary: 删除意向学校
parameters:
- name: id
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getApplyPlanList:
get:
operationId: getApplyPlanList
tags:
- ngdiyselectschool
summary: 获取申请方案列表
description: 获取衔接专业列表
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_Map_string_object_5812ac'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getCartCountry:
get:
operationId: getCartCountry
tags:
- ngdiyselectschool
summary: 获取用户意向列表（隐藏已经提交的意向单）
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_Map_string_object_43a756'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getCartCountry2:
get:
operationId: getCartCountry2
tags:
- ngdiyselectschool
summary: 获取用户意向列表（显示全部的意向单）
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_Map_string_object_43a756'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getCartCountryCount:
get:
operationId: getCartCountryCount
tags:
- ngdiyselectschool
summary: 获取用户意向列表数量
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_Map_string_object_5812ac'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getCartMajorView:
get:
operationId: getCartMajorView
tags:
- ngdiyselectschool
summary: 添加专业弹出层列表-分页 数据
parameters:
- name: degreeId
in: query
required: true
schema:
type: integer
format: int32
- name: schoolId
in: query
required: true
schema:
type: integer
format: int32
- name: pageNo
in: query
required: false
schema:
type: integer
format: int32
- name: keywords
in: query
required: false
schema:
type: string
- name: pro
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_Map_string_object_5812ac'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getCoursesType:
get:
operationId: getCoursesType
tags:
- ngdiyselectschool
summary: 获取就读课程类型
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_string_f13f7f'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getCurrentSchoolsByName:
get:
operationId: getCurrentSchoolsByName
tags:
- ngdiyselectschool
summary: 根据关键字模糊搜索就读学校
parameters:
- name: schoolName
in: query
required: true
schema:
type: string
- name: limitSize
in: query
required: false
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_University_5b7f89'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getJoinMajor:
get:
operationId: getJoinMajor
tags:
- ngdiyselectschool
summary: 获取衔接专业列表
parameters:
- name: courseId
in: query
required: false
schema:
type: integer
format: int32
- name: degreeId
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
description: thirdChannelI
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_Major_58fd76'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getLanguageType:
get:
operationId: getLanguageType
tags:
- ngdiyselectschool
summary: 语言类型枚举DIy
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_string_f13f7f'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getMajorCategoryByDirectionId:
get:
operationId: getMajorCategoryByDirectionId
tags:
- ngdiyselectschool
summary: 获取专业分类(小类)
parameters:
- name: directionId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_MajorCategory_f959a6'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getMajorDirection:
get:
operationId: getMajorDirection
tags:
- ngdiyselectschool
summary: 获取专业方向(大类)
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_MajorDirection_55f171'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getOneStep:
get:
operationId: getOneStep
tags:
- ngdiyselectschool
summary: 获取diy第一划数据
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_Map_string_object_5812ac'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getSchoolList:
get:
operationId: getSchoolList
tags:
- ngdiyselectschool
summary: 普通查询、智能排序和关键词搜索选校列表
parameters:
- name: countryId
in: query
required: true
schema:
type: integer
format: int32
- name: degreeId
in: query
required: true
schema:
type: integer
format: int32
- name: sort
in: query
required: false
schema:
type: string
- name: filter
in: query
required: false
schema:
type: string
- name: categoryId
in: query
required: false
schema:
type: integer
format: int32
- name: page
in: query
required: false
schema:
type: integer
format: int32
- name: query
in: query
required: false
schema:
type: string
- name: limit
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_IntelligentSchool_807cb4'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getUserType:
get:
operationId: getUserType
tags:
- ngdiyselectschool
summary: getUserType
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_int_f2bae6'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getUsersThreestepsIsFull:
get:
operationId: getUsersThreestepsIsFull
tags:
- ngdiyselectschool
summary: 判断用户三滑信息是否完整
description: 获取用户三滑VO数据
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/getUsersThreestepsVO:
get:
operationId: getUsersThreestepsVO
tags:
- ngdiyselectschool
summary: 获取用户三滑VO数据
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_UserDiyThreestepVO_a0208d'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/intelligent:
get:
operationId: queryApplyCountByUniversity
tags:
- ngdiyselectschool
summary: 根据用户背景获取智能选校结果--智能选校
parameters:
- name: keywords
in: query
required: false
schema:
type: string
- name: countryId
in: query
required: false
schema:
type: integer
format: int32
- name: rankType
in: query
required: false
schema:
type: string
- name: degreeName
in: query
required: false
schema:
type: string
- name: currPage
in: query
required: false
schema:
type: integer
format: int32
- name: pageSize
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_Map_string_object_43a756'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/readSearchChinaSchoolMajorXML2String:
get:
operationId: readSearchChinaSchoolMajorXML2String
tags:
- ngdiyselectschool
summary: 模糊查询就读专业
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
- name: count
in: query
required: false
schema:
type: integer
format: int32
- name: searchKey
in: query
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_List_Docele_6e8881'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/recordSceneSrc:
get:
operationId: recordSceneSrc
tags:
- ngdiyselectschool
summary: 场景渠道记录
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
- name: platform
in: query
required: true
schema:
type: string
- name: channel
in: query
required: true
schema:
type: string
- name: scene
in: query
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/saveUsersOneSteps:
get:
operationId: saveUsersOneSteps
tags:
- ngdiyselectschool
summary: 保存第一滑和第二滑信息
parameters:
- name: hopeYear
in: query
required: true
schema:
type: integer
format: int32
- name: hopeCountry
in: query
required: true
schema:
type: integer
format: int32
- name: attendGrade
in: query
required: true
schema:
type: integer
format: int32
- name: edus
in: query
required: true
schema:
type: string
- name: hopeQuarter
in: query
required: false
schema:
type: integer
format: int32
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/saveUsersThreesteps:
post:
operationId: saveUsersThreesteps
tags:
- ngdiyselectschool
summary: 保存三滑信息
requestBody:
required: false
content:
application/json:
schema:
$ref: '#/components/schemas/UserDiyInfoVO'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'201':
description: Created
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/sendNotice:
get:
operationId: getSendNotice
tags:
- ngdiyselectschool
summary: getSendNotice
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/submitIntentions:
get:
operationId: submitIntentions
tags:
- ngdiyselectschool
summary: 提交意向单审核
parameters:
- name: cartSchoolIds
in: query
required: false
schema:
type: string
- name: cartMajorIds
in: query
required: false
schema:
type: string
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
/ngdiyselectschool/validateGoods:
get:
operationId: validateGoods
tags:
- ngdiyselectschool
summary: 验证是否可以确认
parameters:
- name: session
in: query
required: true
schema:
type: string
- name: thirdChannelId
in: query
required: true
schema:
type: integer
format: int32
- name: goodsId
in: query
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/HttpResult_boolean_f50dfc'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
x-swagger-1-2-source: https://www.51offer.com/api-docs/default/ngdiyselectschool
components:
schemas:
MajorDirection:
type: object
properties:
id:
type: integer
format: int32
countryId:
type: integer
format: int32
schoolId:
type: integer
format: int32
gradeId:
type: integer
format: int32
cname:
type: string
ename:
type: string
keyword:
type: string
majorCount:
type: integer
format: int32
x-swagger-1-2-name: MajorDirection
SchoolRank:
type: object
properties:
id:
type: integer
format: int32
country:
type: string
year:
type: integer
format: int32
type:
type: string
ranking:
type: integer
format: int32
showRank:
type: string
score:
type: string
countryId:
type: integer
format: int32
x-swagger-1-2-name: SchoolRank
HttpResult_List_MajorCategory_f959a6:
type: object
properties:
message:
type: string
code:
type: integer
format: int32
data:
type: array
items:
$ref: '#/components/schemas/MajorCategory'
header:
type: string
page:
$ref: '#/components/schemas/Page'
apiInfo:
$ref: '#/components/schemas/ApiInfo'
x-swagger-1-2-name: HttpResult«List«MajorCategory»»
HttpResult_List_IntelligentSchool_807cb4:
type: object
properties:
message:
type: string
code:
type: integer
format: int32
data:
type: array
items:
$ref: '#/c
# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/51offer/refs/heads/main/openapi/51offer-ngdiyselectschool-api-openapi.yml