-
Notifications
You must be signed in to change notification settings - Fork 1
Students
Students are applicants in the Xtern recruiting process. They contain all the necessary information required for viewing student information and comments related to them made by recruiters.
The following routes are supported for performing operations on the Student entity.
CreateStudent POST /student
GetStudent GET /student/{studentKey}
GetStudents GET /student
ExportStudents GET /student/export
SetGrade PUT /student/{studentKey}/grade
SetStatus PUT /student/{studentKey}/status
(Deprecated) UpdateResume POST /student/{Id}
Skills are categorized in order to provide filtering for a particular desired skill domain and to provide a color code for skills to make recruiting easier.
name string Language or skill name
category string Category the language falls under
Grades are given in the recruitment process to provide a ranking mechanism for Students. Each Grade contains the key to the reviewer and the associated grade.
reviewer int Id of the reviewer grade float Numeric value of assessment to control granularity
authorName string Author of Comment
author int Id of the author message string Content of comment
A Student contains all the information that was filled out during the application process. The Student uses the Language, Grade and Comment structures for fields.
_id int64 Id reference
firstName string First name
lastName string Last name
email string Email address
university string University attended
major string Student major
gradYear string Expected graduation year
workStatus string Current work status (Citizen, Visa, etc.)
homeState string Home state
gender string Gender
skills List of(Skill) List of known programming languages and skills
resume string Link to resume for retrieval
linkedinUrl string Link to LinkedIn profile
personalWebiteUrl string Link to personal website
interests List of(string) List of job types student is interested in
grade float Grade from reviewing the student
reviewerGrades List of(Grade) Grades from reviewers of the student
status string Current status in the Recruitment process
Note: to run in Postman, just take the information contained in the quotes of --data and paste in the body field.
Takes an array of students and adds them to the database
(POST) xtern-matching.appspot.com/student
curl -X POST xtern-matching.appspot.com/student \
--data '[{
"firstName": "Darla",
"lastName": "Leach",
"email":"[email protected]",
"university": "Rose-Hulman Institute of Technology",
"major": "Computer Engineering",
"gradYear": "2017",
"workStatus": "US Citizen",
"homeState": "West Virginia",
"gender": "female",
"languages": [{"name": "Hadoop", "category": "Database"},
{"name": "Firebase", "category": "Database"}],
"resume": "",
"githubUrl": "https://github.com/xniccum",
"linkedinUrl": null,
"personalWebiteUrl": null,
"interestedIn": ["Software Engineer- Middle-tier Dev.", "Product Management"],
"interestedInEmail": "false",
"r1Grade": {"text": "C", "value": "2"},
"status": "Stage 1 Approved",
"comments": [{"author": "Yesenia Larsen", "group": "Xtern", "text": "Lorem ipsum ..."}]}]'None
Invalid Student JSON formatting
Invalid structure for Datastore
Retrieves the requested Student by Id
xtern-matching.appspot.com/student/{Id}
curl -X GET xtern-matching.appspot.com/student/01234567Student JSON representation. See Student data format for more information.
Missing or invalid Id in request
Datastore ErrFieldMismatch if types do not agree of if data structure models differ
Retrieves all Students in the database
xtern-matching.appspot.com/student
curl -X GET xtern-matching.appspot.com/studentList of Student JSON representations from entire dataset. See Student data format for more information.
Datastore ErrFieldMismatch if types do not agree of if data structure models differ
Exports all students in the database to a csv file
xtern-matching.appspot.com/student/export
curl -X GET xtern-matching.appspot.com/student/exportstudents.csv : Exported list of students in CSV formatting
Datastore ErrFieldMismatch if types do not agree of if data structure models differ
Sets the Grade of a particular student
xtern-matching.appspot.com/{studentKey}/grade
curl -X GET xtern-matching.appspot.com/{studentKey}/grade
--data '{grade : 5.0}'None
Datastore ErrFieldMismatch if types do not agree of if data structure models differ
Sets the Status of a particular student
xtern-matching.appspot.com/{studentKey}/status
curl -X GET xtern-matching.appspot.com/{studentKey}/status
--data '{status : "Accepted"}'None
Datastore ErrFieldMismatch if types do not agree of if data structure models differ
(Deprecated) Updates the resume of a particular student
xtern-matching.appspot.com/student/resume/{Id}
curl -X POST xtern-matching.appspot.com/student/resume/01234567 \
-F "[email protected]"None
Maximum alotted file size of 8Mb exceeded Missing or invalid Id in request
No file included in multi-part form
Error creating storage bucket if nonexistent
Error adding resume to storage bucket
Error retrieving student
Error updating student