History

CDC-IITDH 0560690192 Update admin.py		2021-10-24 21:00:30 +05:30
..
APIs	Update admin.py	2021-10-24 21:00:30 +05:30
CDC_Backend	Initial Commit	2021-10-15 20:47:23 +05:30
templates	Initial Commit	2021-10-15 20:47:23 +05:30
README.md	Update README.md	2021-10-15 20:53:19 +05:30
client_secret_956830229554-290mirc16pdhd5j7ph7v7ukibo4t1qcp.apps.googleusercontent.com (2).json	Initial Commit	2021-10-15 20:47:23 +05:30
manage.py	Initial Commit	2021-10-15 20:47:23 +05:30

README.md

API References

Common APIs
1. api/login/
Student APIs
Common Errors

Common APIs

`api/login/`

This Api is used to Verify the user and find out the role he/she has

How to Use?

Send a POST request to api/login/
Request_Body:

{}

Response

Response is a Json with these fields

{
    "action": "Login",
    "message": "Verified",
    "user_type": [
        "student"
    ]
}

action: Tells us about the message creator
message: Tells us what happened with our Request.
user_type: Tells us about the role the user possess. Can have these values
- student
- Admin

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	`Verified`

You may see some different errors which can be seen here

Student Portal APIs

`api/student/profile`

This Api is used to get the profile of the student.

How to Use?

Send a GET request to api/student/profile
Request_Body:

{}

Response

Response is a Json with these fields

{
    "action": "Student Profile",
    "message": "Details Found",
    "details": {
        "id": "fdgdb",
        "roll_no": 190010036,
        "name": "Gowtham Sai",
        "batch": "THIRD",
        "branch": "CSE",
        "phone_number": 9390291911,
        "resumes": [
           "XB85F4RIGBF5VJN_Cv-Gowtham.pdf"
        ],
        "cpi": "9.02"
    }
}

action: Tells us about the message creator
message: Tells us what happened with our Request.
details: Has the student data.

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	`Details Found`
400 BAD_REQUEST	`Error Occurred {error}`

You may see some different errors which can be seen here

`api/student/getDashboard`

This Api is used to get all the placements applicable to the student.

How to Use?

Send a GET request to api/student/Dashboard

Request_Body:

{}

Response

Response is a Json with these fields

{
    "action": "Placement and Internships",
    "message": "Data Found",
    "placements": [
        {
            "id": "fdgdb121",
            "designation": "Software Developer",
            "description": "nice job",
            "start_date": "2021-06-17",
            "city": "Mumbai",
            "city_type": "Domestic",
            "compensation": 1200000,
            "compensation_details": "",
            "allowed_batch": [
                "THIRD",
                "FOURTH"
            ],
            "allowed_branch": [
                "CSE",
                "EE",
                "ME"
            ],
            "attachments": [],
            "rounds": [
                "Resume Shortlisting",
                "Technical Test",
                "Interview"
            ],
            "additional_info": [
                "school",
                "place of study",
                "language"
            ],
            "status": "Resume Shortlisting",
            "rounds_details": {
                "Interview": "One -to-One interview",
                "Technical Test": "Online Technical test which will be monitored remotely",
                "Resume Shortlisting": "Resume will be seen"
            },
           "company_details": {
                "id": "fdgdb",
                "name": "Apple",
                "address": "California",
                "companyType": "Technology",
                "website": ""
            }
        }
    ],
    "placementApplication": [
        {
            "id": "dsdads",
            "application_status": "Resume Shortlisting",
            "resume": "XB85F4RIGBF5VJN_Cv-Gowtham.pdf",
            "additional_info": {
                "school": "Delhi Public School",
                "language": "Telugu",
                "place of study": "Visakhapatnam"
            },
            "selected": null,
            "placement": "fdgdb121"
        }
    ]   
}

action: Tells us about the message creator
message: Tells us what happened with our Request.
placements: Has the placements data.
internships: Has the internships data.
application_status: Can have many names
- Accepting Applications
- One of the Round Names
- Completed
selected: Can take three Values
- null: Student is still in the Selection process
- true: Student is Selected
- false: Student is not selected

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	`Resume Added`
400 BAD_REQUEST	`Error Occurred {error}`

You can see some common errors here

`api/student/addResume/`

This Api is used to add resumes by a student.

How to Use?

Send a POST request to api/student/addResume/

Request_Body:

{
  "file": "__FILE_OBJECT__"
}

Response

Response is a Json with these fields

{
  "action": "Upload Resume",
  "message": "Resume Added"
}

action: Tells us about the message creator
message: Tells us what happened with our Request.

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	`Resume Added`

You can see some common errors here

`api/student/deleteResume/`

This Api is used to delete resumes added by a student.

How to Use?

Send a POST request to api/student/deleteResume/

Request_Body:

{
  "resume_file_name": "8ZJ44RIS9914SO4_Resume for Google STEP.pdf"
}

Response

Response is a Json with these fields

{
  "action": "Delete Resume",
  "message": "Resume Deleted"
}

action: Tells us about the message creator
message: Tells us what happened with our Request.

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	`Resume Deleted`
404 NOT FOUND	`File Not Found`

You can see some common errors here

`api/student/submitApplication/`

This Api is used to submit application to Internships/Placements.

How to Use?

Send a POST request to api/student/submitApplication/

Request_Body:

{
  "opening_type": "Placement",
  "opening_id": "fgervsdgdsf",
  "resume_file_name": "1FYE0PQZZ508HR6_Resume for Google STEP.pdf",
  "additional_info": {
    "school": "Narayana English Medium",
    "place of study": "Vizag",
    "language": "Telugu"
  }
}

opening_type: Can be Placement/Internship
opening_id: Opening Id unique to each opening.
additional_info: This is the info which the Internship/Placement demands besides the normal user data which has to asked and sent. These fields can be found in the Internship Details.

Response

Response is a Json with these fields

{
  "action": "Submit Application",
  "message": "Application Submitted"
}

action: Tells us about the message creator
message: Tells us what happened with our Request.

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	`Application Submitted`
403 FORBIDDEN	`Application is already Submitted`
404 NOT FOUND	`RESUME_FILE_NAME Not Found`

You can see some common errors here

`Common Errors`

Some common errors that you may see while accessing the Apis

Status Codes	Possible Messages	Possible Reasons
401 UNAUTHORIZED	`Authorization Header Not Found`	Check for the authorization header in you request and the prefix( Should use `Bearer`) used.
401 UNAUTHORIZED	`Access Denied. You are not allowed to use this service`	Your may not have required access to those access those Apis.
401 UNAUTHORIZED	`Token has wrong audience`	You may be using wrong credentials for Google OAuth2.0.
404 NOT FOUND	`User Not Found. Contact CDC for more details`	You may not be a user at CDC, IIT Dharwad. Please contact us to get your user account
400 BAD_REQUEST	`Error Occurred {error}`	Any random Error which can be seen in the {error} string.