The basic configuration

Base address:

1. API authentication uses token authentication and data return uses JSON. Cors is enabled on the server to resolve cross-domain problems. 2. Request method

  • GET (SELECT) : Retrieves one or more resources from the server.
  • POST (CREATE) : Creates a resource on the server.
  • PUT (UPDATE) : Updates the resource on the server (the client provides the full resource after the change).
  • DELETE (DELETE) : deletes resources from the server.
  1. The interface failed to return data
 {
    "data": {},"meta": {
        "msg": "Error"."status": 0}}Copy the code

The interface subsidiary

1.1 Login Interface

  • Request path: login
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
username The user name The value cannot be empty. The user name is student ID
password The user password The value cannot be empty. The default value is student ID
  • The response data
{
    "data": {
        "id":1."username": "201719044120"."first_name": "Zhang"."roles": "student".// Can only be student or manager
        "token": "cdscij"
    },
    "meta": {
        "msg": "Login successful"."status": 200}}Copy the code

1.2 Personal Information (Students’ personal information is not required by the administrator)

1.2.1 Uploading Personal Information

  • Request path: user/complete_userInfo
  • Request method: POST
  • Student request parameters (name and class, major imported for the administrator, students can not modify)
Parameter names Parameters that note
username The user name
age age
email email
avatar Head portrait The url address
phone_num Mobile phone no.
sex gender Male or female only
study_year “2017-09-01, 2017-09-01” It is a string for back-end storage and an array when returned to the front end
is_work Whether employment 0, 1, 2, 3, 4,-1 Job hunting, 0 internship, 1 employment, 2 graduate school success, 3 continue learning, 4 others
study_status Learning situation Student’s summary of personal learning status and situation (optional)
  • The response data
{
    "data": {
        "username":"201719044120"."first_name": "Zhang"."created_time":"28 March 2020"
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.2.2 Obtaining personal Information

  • Request path: user/complete_userInfo
  • Request method: get
  • Request parameters
Parameter names Parameters that note
username The user name
  • Student: Response data
{
    "data": {
        "username":"201719044120"."first_name": "Zhang"."age": 22."email":"[email protected]"."avatar":"http://123456"."phone_num":"1328371"."stu_class":"Network, 171"."sex":"Male"."magor":"Software Engineering"."study_year": ["2017-09-01"."2021-06-01"]."is_work": 0.//-1 job hunting, 0 internship, 1 employment, 2 graduate school success, 3 continue learning, 4 others
        "study_status":"Learning the front end."."created_time":"28 March 2020"
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.2.3 Modifying Personal Information

  • Request path: user/complete_userInfo
  • Request method: put
  • Student request parameters
Parameter names Parameters that note
username The user name
age age
email email
avatar Head portrait The url address
phone_num Mobile phone no.
sex gender Male or female only
study_year In the school time An array type
is_work Whether employment -1 Job hunting, 0 internship, 1 employment, 2 graduate school success, 3 continue learning, 4 others
study_status Learning situation Student’s summary of personal learning status and situation (optional)
  • The response data
{
    "data": {
        "username":"201719044120"."first_name": "Zhang"."updated_time":"2020-3-28",},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.3 Student employment registration

1.3.1 Students upload employment information

  • The request path is user/employ_register
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
username The user name
company_id Company name
adress “Beijing/District/Dongcheng District /” String type
code_adress [” 100010 “, “120000”, “10000”] Array type, address code
company_phone The phone company String type
entry_time In the time The dates are all strings of type 2020-3-28
pos_name Job title
is_train Whether the training 0 no, 1 training
agreement_id The three parties agreement The url address
salary salary Can be null
  • The response data
{
    "data": {
        "username":"201719044120"."first_name":"Cheung chi"."created_time":"2020-3-28"
      
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.3.2 Students obtain employment information

  • The request path is user/employ_register
  • Request method: get
  • Request parameters
Parameter names Parameters that note
username The user name
  • Response data (null if there is no value corresponding data, exampleis_train:"" )
{
    "data": {
        "username":"201719044120"."company_id":hikvision."adress":"Beijing/City District, dongcheng District /".// Address Chinese name
        "code_adress": ["100010"."120000"."10000"].// Address code
        "company_phone":"1232831"."entry_time":"2020-3-28"."pos_name":"The web front end"."is_train":0.// Have you received any training? 0 no, 1 has received any training
         "is_work":0.// Current employment status
         "agreement_id":"http://123456"."salary":13000."first_name":"Cheung chi",},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.3.3 Students modify their employment registration information

  • The request path is user/employ_register
  • Request method: put
  • Request parameters
Parameter names Parameters that note
username The user name
company_id Company name
adress “Beijing/District/Dongcheng District /” String type
code_adress [” 100010 “, “120000”, “10000”] Array type, address code
entry_time In the time
company_phone The phone company String type
pos_name Job title
is_train Whether the training 0 no, 1 training
agreement_id The three parties agreement Store URL address
salary salary
  • The response data
{
    "data": {
        "username":"201719044120"."first_name":"Cheung chi"."updated_time":"28 March 2020"
      
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.3.4 Changing the Login Password

  • Request path: user/modify_password
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
username The user name
password password
  • The response data
{
    "data": {
        "username":"201719044120"."updated_time":"28 March 2020"
      
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.4 The administrator uploads student information

1.4.1 Importing student information through Excel

  • Request address manager/upload_user_info
  • Request method POST
  • Request parameters
Parameter names Parameters that note
userInfo Object type 
userInfo:[
   {username:"201719044120".first_name:"Cheung chi".stu_class:"RB soft network".magor:"Web software Development"}，
   {username:"201719044121".first_name:"Cheung chi".stu_class:"RB soft network".magor:"Web software Development"}，
   {username:"201719044122".first_name:"Cheung chi".stu_class:"RB soft network".magor:"Web software Development"}，
   {username:"201719044123".first_name:"Cheung chi".stu_class:"RB soft network".magor:"Web software Development"},]Copy the code
  • The response data
{
    "data": {},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.5 Information Center

1.5.1 Uploading News by the Administrator

  • Request path: manager/upload_news
  • Request method: POST, back end for each news to add a unique ID
  • Request parameters
Parameter names Parameters that note
news_title News headlines Can’t be empty
news_content News content Can’t be empty
news_picture News pictures Can be null
  • The response data
{
    "data": {
        news_id:10 ,// The backend generates a unique ID for each news item
        news_title:"Study hard.".news_content:"Up every day".news_picture:"", created_time;""
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.5.2 The administrator modifies news

  • Request path: manager/upload_news
  • Request method: put
  • Request parameters
Parameter names Parameters that note
news_id Press number
news_title News headlines Can’t be empty
news_content News content Can’t be empty
news_picture News pictures Can be null
  • The response data
{
    "data": {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"", created_time:""
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.5.3 Deleting news

  • Request path: manager/upload_news
  • Request method: delete
  • Request parameters
Parameter names Parameters that note
news_id Press number
  • The response data
{
    "data": {},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.5.4 Get all the news

  • Request path: manager/upload_news

  • Request method: get

  • Request parameters

  • The response data


{
    "data": {
        all_news:[ {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"", created_time:""
    },
     {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"", created_time:""}},],"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.6 Students get news (students have one more field has_collect)

1.6.1 Students click “Favorites”

  • Request path: user/to_collect_news
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
news_id Press number
username The user name
  • The response data

{
    "data": {
       "collect_num":9// The number of news items already collected
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.6.2 Students click to cancel favorites

  • Request path: user/to_collect_news
  • Request method: put
  • Request parameters
Parameter names Parameters that note
news_id Press number
username The user name
  • The response data

{
    "data": {
       "collect_num":8// The number of news items already collected
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.6.3 Students get all news lists

  • Request path: user/all_news
  • Request method: get
  • Request parameters
Parameter names Parameters that note
username The user name
  • The response data

{
    "data": {
        all_news:[ {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"".has_collect: true, created_time:""
    },
     {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"".has_collect: false, created_time:""},]."collect_num": 10 // Collect news items
      
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.6.4 Students get the list of favorite news

  • Request path: user/collect_news
  • Request method: get
  • Request parameters
Parameter names Parameters that note
username The user name
  • The response data

{
    "data": {
        all_news:[ {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"".has_collect: true, created_time:""
    },
     {
        news_id:10 // The backend generates a unique ID for each news item
        news_title:"".news_content:"".news_picture:"".has_collect: true, created_time:""}},],"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.7 The administrator obtains the employment information submitted by students

1.7.1 The administrator obtains the unchecked employment information of students (only the submitted employment information is returned, and all the information is unchecked)

  • Request path: Manager /auditInfo
  • Request method: get
  • Request parameters (parameters can be null)
Parameter names Parameters that note
key The keyword Support fuzzy query, you can enter the name or student ID, can be empty
stu_class The class Empty returns all unaudited employment information, can also select classes, support multiple selection
  • The response data
{
    "data": {
     "allAuditInfo": [{"auditInfo": 0.// Audit status 0 is not audited, and 1 is approved
        "username":"201719044120"./ / user name
        "company_id":hikvision.// Company name
        "adress":"Beijing/District/Dongcheng District /".// Company address
        "company_phone":"1232831".// Company mobile number
         "entry_time":"2020-3-28".// Start time
         "pos_name":"The web front end"./ / position
         "is_train":0.// Whether to train
         "is_work":0.// Employment status, currently internship
         "agreement_id":"http://123456".Employment contract PDF, url address
         "salary":13000./ / salary
         "first_name":"Cheung chi"."age": 22."email":"[email protected]"."phone_num":"1328371"."stu_class":"Network, 171"."sex":"Male"."magor":"Software Engineering"."study_status":"Learning the front end."}, {... }, {... }... ] },"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.7.2 The administrator submits the verified employment information of students

  • Request path: manager/submit_auditInfo
  • Request method: POST
  • Request parameters (array parameters)
Parameter names Parameters that note
allUserName Verified student ID (USERNAME)
  • Example request parameters

AllUserName: [" 201719044120 ", "201719044121"...

  • The response data

{
    "data": {},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.7.3 The administrator submits the employment information of students that has been checked and failed

  • Request path: manager/submit_unauditInfo
  • Request method: POST
  • Request parameters (array parameters)
Parameter names Parameters that note
allUserName Student ID (USERNAME) that has been checked but failed
  • Example request parameters

AllUserName: [" 201719044120 ", "201719044121"...

  • The response data

{
    "data": {},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.7.4 The administrator obtains the employment information of all students

  • The request path is manager/all_employInfo
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
stu_class The class An array type
status There are five options String type

  • Request parameter status value: EmpInfo: obtain the information of all students whose employment information has been submitted. HasAudit: Obtain the information of all students whose employment information has been submitted and passed the audit. HasErrorAudit: obtains the information of students whose employment information has been submitted but not passed the audit. NoAudit: Obtains the information of students whose employment information has been submitted but not passed the audit

  • The response data

  • The response data

{
    "data": {
     "allAuditInfo": [{"auditInfo": 0.// The audit status 0 is not audited, 1 is approved, -1 is not approved, and empty is not yet submitted employment information
        "username":"201719044120"./ / user name
        "company_id":hikvision.// Company name
        "adress":"Beijing/District/Dongcheng District /".// Company address
        "company_phone":"1232831".// Company mobile number
         "entry_time":"2020-3-28".// Start time
         "pos_name":"The web front end"./ / position
         "is_train":0.// Whether to train
         "is_work":0.// Employment status, currently internship
         "agreement_id":"http://123456".Employment contract PDF, url address
         "salary":13000./ / salary
         "first_name":"Cheung chi"."age": 22."email":"[email protected]"."phone_num":"1328371"."stu_class":"Network, 171"."sex":"Male"."magor":"Software Engineering"."study_status":"Learning the front end."}, {... }, {... }... ] },"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.7.5 The administrator selects and exports the employment information of students according to the conditions

  • Request path: manager/export_auditInfo
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
stu_class Parameter is array, support multiple class query If it is empty, do not check
status There are five options String type
  • Example request parameters

Stu_class: [“RB softnetwork 171″,”RB softnetwork 172”] status value: stu_class: [“RB softnetwork 171″,”RB softnetwork 172”] EmpInfo: obtain the information of all students whose employment information has been submitted. HasAudit: Obtain the information of all students whose employment information has been submitted and passed the audit. HasErrorAudit: obtains the information of students whose employment information has been submitted but not passed the audit. NoAudit: Obtains the information of students whose employment information has been submitted but not passed the audit

  • The response data

{
    "data": {
       "json_fields": {"Name":"first_name"."Student id":"username"."Class": "stu_class"."Employment Status":"is_work"."Training or not?":"is_train"."Personal Mobile number":"phone_num"."Company Name":"company_id"."Company Address":"adress"."Company Phone": "company_phone"."就业岗位":"pos_name"
       },
       "json_data":[
         {
          "first_name":"Cheung chi"."username":"201719044120"."stu_class":"RB soft industrial network 171"."is_work" : "In practice".// The number stored in the database is returned in Chinese
          "is_train" : "No."// The number stored in the database is returned in Chinese
          "phone_num":"13283719964"."company_id":"Daoyuan Group"."adress":"Beijing"."company_phone":"Company Phone"."pos_name":"就业岗位"
         },
         {"first_name":"Cheung chi"."username":"' 201719044120 '".// The string must be enclosed with a small quotation mark
          "stu_class":"RB soft industrial network 171"."is_work" : "In practice".// The number stored in the database is returned in Chinese
          "is_train" : "No."// The number stored in the database is returned in Chinese
          "phone_num":"13283719964"."company_id":"Daoyuan Group"."adress":"Beijing"."company_phone":"1321123"."pos_name":"Front-end development"}...
       ]
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.8 Statistical information on employment status of students

1.8.1 Obtain employment status data of all students, such as employment, internship, successful postgraduate entrance examination…

  • Request path: manager/workStatus
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
stu_class Parameter is array, support multiple class query If it is empty or not, the employment status of all students is obtained
  • Parameters of the sample

Stu_class: [“RB softnet 175 “,”RB softnet 175 “] stu_class: [“RB softnet 175 “,”RB softnet 175 “]

  • The response data
{
    "data": {
       "emp_num": [{"value": 1048."name": 'Looking for a job'},//value Indicates the number of people, for example, 1084
                {"value": 735."name": 'In practice'},
                {"value": 580."name": 'Employed'},
                {"value": 484."name": 'Success in postgraduate entrance examination'},
                {"value": 300."name": 'Keep learning'},
                {"value": 300."name": 'other'}]."detail_num": 200Emp_num = emp_num = emp_num
      
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.9 Data analysis of training and untraining

  • Request path: Manager /is_train
  • Request method: POST
  • Request parameters
Parameter names Parameters that note
stu_class Parameter is array, support multiple class query If it is empty or not, the employment status of all students is obtained
  • Parameters of the sample

Stu_class: [“RB softnet 175 “,”RB softnet 175 “] stu_class: [“RB softnet 175 “,”RB softnet 175 “]

  • The response data
{
    "data": {
       "train_status": {
                 "Average salary": {
                           "has_train":10000.// Average salary after training
                           "no_train":5000.// Average salary for non-training},"The number": {
                           "has_train":100.// The number of people employed and trained
                           "no_train":600.// The number of people who are employed and have not attended training},"Front-end development": {
                           "has_train":100.// People who work on the front end after training
                           "no_train":600.// Not training the front end people},"Back-end development": {
                           "has_train":100.//
                           "no_train":600.//},"UI Designer": {
                           "has_train":100.//
                           "no_train":600.//},"Product Manager": {
                           "has_train":100.//
                           "no_train":600.//},"Software Test Engineer": {
                           "has_train":100.//
                           "no_train":600.//},"Other": {
                           "has_train":100.//
                           "no_train":600.//}},"detail_num": 200// The number of people participating in the statistics
      
    },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.9 Students get recruitment information

1.9.1 Students get recruitment information name list

  • Request path: user/emp_name_list

  • Request method: get

  • Request parameters: None

  • The response data

{
    "data": {
       "empList": [{id:1.name:"Beijing Ocean Company Recruitment information - front and rear end development".empTime:"2021-4-25"}, {id:2.name:Bytedance Job Fair.empTime:"2021-5-3"}],},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.9.2 Students obtain recruitment information details according to recruitment information ID and username

  • Request path: user/ detail_EMP_list
  • Request method: get
  • Request parameters:
Parameter names Parameters that note
id Id number of the recruitment information Must pass, not return null data
username Student student id Must pass
  • The response data

There must be a field has_COLLECT

{
    "data": {
       id:1.// The news id, which uniquely identifies the news
       has_collect:0.// Not yet collected. If it is 1, it is collected
       collect_num:10.// Collect the number of recruitment information
       title:"Bytedance Company Hiring.".// The title of the job Posting
       empTime:"2021-4-25".// Recruitment date
       content:"Development engineer wanted..."// Recruitment introduction
       empPosition: [{empName:"Front-end Development Engineer".empRequire: ["Proficient in VUE"."Proficient in JS"."Master..."] {},empName:"Front-end Development Engineer".empRequire: ["Proficient in VUE"."Proficient in JS"."Master..."]}],empContact: {empNetWork:"www.bytedance.com"./ / website
       empAdress:"Haidian District, Beijing".empPhone:"13283719964"/ / phone}},"meta": {
        "msg": "Success"."status": 200}}Copy the code

1.9.3 Students click to favorites recruitment information

  • Request path: user/collect_employment
  • Request method: POST
  • Request parameters:
Parameter names Parameters that note
job_id Id number of the recruitment information
username Student id
  • The response data

There must be a field collect_num (number of collections)

{
    "data": {
           collect_num:10 // Collect the number of recruitment information
         },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.9.4 Students click to uncollect recruitment information

  • Request path: user/collect_employment
  • Request method: put
  • Request parameters:
Parameter names Parameters that note
job_id Id number of the recruitment information
username Student id
  • The response data

There must be a field collect_num (number of collections)

{
    "data": {
           collect_num:10 // Collect the number of recruitment information
         },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

1.9.5 Students get a list of favorite recruitment information

  • Request path: user/collect_employment
  • Request method: get
  • Request parameters:
Parameter names Parameters that note
username Student id
  • The response data
{
    "data": {
       "empList": [{id:1.name:"Beijing Ocean Company Recruitment information - front and rear end development".empTime:"2021-4-25"}, {id:2.name:Bytedance Job Fair.empTime:"2021-5-3"}],},"meta": {
        "msg": "Success"."status": 200}}Copy the code

2.0 Jobs Report

2.0.1 Release of employment report

  • Request path: Manager /release_report
  • Request method: POST
  • Request parameters:
Parameter names Parameters that note
reportUrl Url of the employment report Such as www.baidupdf.com
  • The response data
{
    "data": {},"meta": {
        "msg": "Success"."status": 200}}Copy the code

2.0.2 Get employment report

  • Request path: Manager /release_report

  • Request method: get

  • Request parameters:

  • The response data

{
    "data": {
           reportUrl:"www.baidupdf.com"// The url of the employment report
       
         },
    "meta": {
        "msg": "Success"."status": 200}}Copy the code

2.0.1 Deleting the employment report

  • Request path: Manager /release_report

  • Request method: delete

  • Request parameters:

  • The response data

{
    "data": {},"meta": {
        "msg": "Success"."status": 200}}Copy the code

3.0 Administrator – Recruitment Information

3.0.1 Release recruitment information