cdc-placement-website-backend/CDC_Backend

API References

1. Common APIs
   1. api/login/
2. Student APIs
   1. api/student/profile/
   2. api/student/getDashboard/
   3. api/student/addResume/
   4. api/student/deleteResume/
   5. api/student/submitApplication/
3. Admin APIs
   1. api/admin/markStatus/
   2. api/admin/getDashboard/
   3. api/admin/updateDeadline/
   4. api/admin/updateOfferAccepted
   5. api/admin/updateEmailVerified
   6. api/admin/updateAdditionalInfo
   7. api/admin/getApplications
   8. api/admin/submitApplication
   9. api/admin/generateCSV
   10. api/admin/addPPO
   11. api/admin/getStudentApplication
4. Company APIs
   1. api/company/addPlacement/
5. 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:

{}

Headers
Authorization: "Bearer {tokenID}"

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:

{}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Student Profile",
  "message": "Details Found",
  "details": {
    "id": "190010036",
    "resume_list": [
      {
        "link": "https://storage.googleapis.com/cdc-backend-attachments/resume/190010036%2F8KIOT3PW1JIS718_CSE-V-SEM.pdf",
        "name": "8KIOT3PW1JIS718_CSE-V-SEM.pdf"
      }
    ],
    "offers": [
      {
        "designation": "Software Developer",
        "company_name": "Make My Trip",
        "application_id": "LLW4STE76GEJYOR"
      }
    ],
    "roll_no": 190010036,
    "name": "Gowtham Sai",
    "batch": "2019",
    "branch": "CSE",
    "phone_number": 9390291911,
    "cpi": "9.15"
  }
}

• 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	Something Went Wrong

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 and his applications which he has already applied.

How to Use?

Send a GET request to api/student/getDashboard

Request_Body:

{}

Headers
Authorization: "Bearer {tokenID}"

Only users with student role can access this Api.

Response

Response is a Json with these fields

{
  "action": "Get Dashboard - Student",
  "message": "Data Found",
  "placements": [
    {
      "id": "Q54IRZZMC3RP8F6",
      "company_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FI5U4RDTV0OP0EM0_2019+Student+Details+-+Total%28State+Sort%29+-+Copy.pdf",
          "name": "I5U4RDTV0OP0EM0_2019 Student Details - Total(State Sort) - Copy.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FW04JWWNNMIBX0JX_2019+Student+Details+-+Total%28State+Sort%29.pdf",
          "name": "W04JWWNNMIBX0JX_2019 Student Details - Total(State Sort).pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FT1BXP98WBT9BHOR_AP0313017732021LL-Driving+Licence+-+Copy.pdf",
          "name": "T1BXP98WBT9BHOR_AP0313017732021LL-Driving Licence - Copy.pdf"
        }
      ],
      "description_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FC78TE2Z67BPZ41O_CSE-V-SEM.pdf",
          "name": "C78TE2Z67BPZ41O_CSE-V-SEM.pdf"
        }
      ],
      "compensation_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2F8D5OFQ46H43DD3S_module5And6Attendance.pdf",
          "name": "8D5OFQ46H43DD3S_module5And6Attendance.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FG8OU2PE919PFKSR_Print+Application11.pdf",
          "name": "G8OU2PE919PFKSR_Print Application11.pdf"
        }
      ],
      "selection_procedure_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FDZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_",
          "name": "DZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FN490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3",
          "name": "N490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3"
        }
      ],
      "company_name": "Make My Trip",
      "address": "MakeMyTrip India Pvt. Ltd.5, Awagarh House, MG Road(next to Bachoomal collections)Agra (UP), - 282002India",
      "company_type": "Private Sector",
      "nature_of_business": "Technology",
      "website": "www.makemytrip.com",
      "company_details": "This s a very nice company",
      "is_company_details_pdf": true,
      "city": "Mumbai",
      "state": "Maharashtra",
      "country": "India",
      "pin_code": 530013,
      "city_type": "Domestic",
      "designation": "Software Developer",
      "description": "very nice job",
      "is_description_pdf": true,
      "compensation_CTC": 1200000,
      "compensation_gross": 1100000,
      "compensation_take_home": 1000000,
      "compensation_bonus": 10000,
      "compensation_details": "very good compensation",
      "is_compensation_details_pdf": true,
      "bond_details": "nil",
      "selection_procedure_rounds": [
        "Resume Shortlisting",
        "Technical Interview",
        "HR Interview"
      ],
      "selection_procedure_details": "All rounds are complusory",
      "is_selection_procedure_details_pdf": true,
      "tier": "4",
      "tentative_date_of_joining": "2022-01-15",
      "allowed_batch": ["2018", "2019"],
      "allowed_branch": ["CSE", "EE"],
      "tentative_no_of_offers": 5,
      "other_requirements": "above 8 cpi",
      "additional_info": ["School", "Home Town"],
      "deadline_date": "2021-12-04",
      "created_at": "2021-12-02T20:12:21+05:30"
    }
  ],
  "placementApplication": [
    {
      "id": "LLW4STE76GEJYOR",
      "placement": {
        "id": "Q54IRZZMC3RP8F6",
        "company_details_pdf_links": [
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FI5U4RDTV0OP0EM0_2019+Student+Details+-+Total%28State+Sort%29+-+Copy.pdf",
            "name": "I5U4RDTV0OP0EM0_2019 Student Details - Total(State Sort) - Copy.pdf"
          },
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FW04JWWNNMIBX0JX_2019+Student+Details+-+Total%28State+Sort%29.pdf",
            "name": "W04JWWNNMIBX0JX_2019 Student Details - Total(State Sort).pdf"
          },
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FT1BXP98WBT9BHOR_AP0313017732021LL-Driving+Licence+-+Copy.pdf",
            "name": "T1BXP98WBT9BHOR_AP0313017732021LL-Driving Licence - Copy.pdf"
          }
        ],
        "description_pdf_links": [
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FC78TE2Z67BPZ41O_CSE-V-SEM.pdf",
            "name": "C78TE2Z67BPZ41O_CSE-V-SEM.pdf"
          }
        ],
        "compensation_pdf_links": [
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2F8D5OFQ46H43DD3S_module5And6Attendance.pdf",
            "name": "8D5OFQ46H43DD3S_module5And6Attendance.pdf"
          },
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FG8OU2PE919PFKSR_Print+Application11.pdf",
            "name": "G8OU2PE919PFKSR_Print Application11.pdf"
          }
        ],
        "selection_procedure_details_pdf_links": [
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FDZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_",
            "name": "DZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_"
          },
          {
            "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FN490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3",
            "name": "N490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3"
          }
        ],
        "company_name": "Make My Trip",
        "address": "MakeMyTrip India Pvt. Ltd.5, Awagarh House, MG Road(next to Bachoomal collections)Agra (UP), - 282002India",
        "company_type": "Private Sector",
        "nature_of_business": "Technology",
        "website": "www.makemytrip.com",
        "company_details": "This s a very nice company",
        "is_company_details_pdf": true,
        "city": "Mumbai",
        "state": "Maharashtra",
        "country": "India",
        "pin_code": 530013,
        "city_type": "Domestic",
        "designation": "Software Developer",
        "description": "very nice job",
        "is_description_pdf": true,
        "compensation_CTC": 1200000,
        "compensation_gross": 1100000,
        "compensation_take_home": 1000000,
        "compensation_bonus": 10000,
        "compensation_details": "very good compensation",
        "is_compensation_details_pdf": true,
        "bond_details": "nil",
        "selection_procedure_rounds": [
          "Resume Shortlisting",
          "Technical Interview",
          "HR Interview"
        ],
        "selection_procedure_details": "All rounds are complusory",
        "is_selection_procedure_details_pdf": true,
        "tier": "4",
        "tentative_date_of_joining": "2022-01-15",
        "allowed_batch": ["2018", "2019"],
        "allowed_branch": ["CSE", "EE"],
        "tentative_no_of_offers": 5,
        "other_requirements": "above 8 cpi",
        "additional_info": ["School", "Home Town"],
        "deadline_date": "2021-12-04",
        "created_at": "2021-12-02T20:12:21+05:30"
      },
      "resume_link": "https://storage.googleapis.com/cdc-backend-attachments/resume/LLW4STE76GEJYOR%2F8KIOT3PW1JIS718_CSE-V-SEM.pdf",
      "additional_info": "{\"School\": \"Narayana English Medium High School\", \"Home Town\": \"Vizag\"}",
      "selected": null,
      "applied_at": "2021-12-02T21:58:18.032466+05:30"
    }
  ]
}

• action: Tells us about the message creator
  
• message: Tells us what happened with our Request.
• placements: Array of Placement Objects
• placementApplication: Array of Placement Application Objects

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	Data Found
404 Not Found	Student Not Found
400 BAD_REQUEST	Something Went Wrong

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/

Only users with student role can access this Api.

Request_Body:

{
  "file": "__FILE_OBJECT__"
}

Excepted to send Form Data

Headers
Authorization: "Bearer {tokenID}"

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/

Only users with student role can access this Api.

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"
}

Headers
Authorization: "Bearer {tokenID}"

• 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 Placements.

How to Use?

Send a POST request to api/student/submitApplication/

Only users with student role can access this Api.

Request_Body:

{
  "opening_type": "Placement",
  "opening_id": "Q54IRZZMC3RP8F6",
  "resume_file_name": "8KIOT3PW1JIS718_CSE-V-SEM.pdf",
  "additional_info": {
    "School": "Narayana English Medium High School",
    "Home Town": "Vizag"
  }
}

Headers
Authorization: "Bearer {tokenID}"

• opening_type: Can be Placement
• opening_id: Opening Id unique to each opening.
• additional_info: This is the info which the Placement demands besides the normal user data which has to asked and sent. These fields can be found in the Placement 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
403 FORBIDDEN	Placement Not Approved
404 NOT FOUND	RESUME_FILE_NAME Not Found

You can see some common errors here

---

Admin Portal APIs

api/admin/markStatus

This Api is used to mark the status for application for a specific placement.

How to Use?

Send a POST request to api/admin/markStatus
Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6",
  "student_list": [
    {
      "student_id": "190010036",
      "student_selected": "true"
    },
    {
      "student_id": "190050022",
      "student_selected": "false"
    }
  ]
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Mark Status",
  "message": "Marked Status"
}

• 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	Marked Status
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/getDashboard

This Api is used to get all the placements.

How to Use?

Send a GET request to api/admin/getdashboard

Request_Body:

{}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Get Dashboard - Admin",
  "message": "Data Found",
  "new": [
    {
      "id": "Z54IRZZMB3RP9TR",
      "company_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FI5U4RDTV0OP0EM0_2019+Student+Details+-+Total%28State+Sort%29+-+Copy.pdf",
          "name": "I5U4RDTV0OP0EM0_2019 Student Details - Total(State Sort) - Copy.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FW04JWWNNMIBX0JX_2019+Student+Details+-+Total%28State+Sort%29.pdf",
          "name": "W04JWWNNMIBX0JX_2019 Student Details - Total(State Sort).pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FT1BXP98WBT9BHOR_AP0313017732021LL-Driving+Licence+-+Copy.pdf",
          "name": "T1BXP98WBT9BHOR_AP0313017732021LL-Driving Licence - Copy.pdf"
        }
      ],
      "description_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FC78TE2Z67BPZ41O_CSE-V-SEM.pdf",
          "name": "C78TE2Z67BPZ41O_CSE-V-SEM.pdf"
        }
      ],
      "compensation_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2F8D5OFQ46H43DD3S_module5And6Attendance.pdf",
          "name": "8D5OFQ46H43DD3S_module5And6Attendance.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FG8OU2PE919PFKSR_Print+Application11.pdf",
          "name": "G8OU2PE919PFKSR_Print Application11.pdf"
        }
      ],
      "selection_procedure_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FDZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_",
          "name": "DZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FN490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3",
          "name": "N490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3"
        }
      ],
      "company_name": "Cred",
      "address": "Cred India Pvt. Ltd.5, Awagarh House, MG Road(next to Bachoomal collections)Agra (UP), - 282002India",
      "company_type": "Private Sector",
      "nature_of_business": "Technology",
      "website": "www.cred.com",
      "company_details": "This s a very nice company",
      "is_company_details_pdf": true,
      "contact_person_name": "John",
      "phone_number": 9390291922,
      "email": "@gmail.com",
      "city": "Mumbai",
      "state": "Maharashtra",
      "country": "India",
      "pin_code": 530013,
      "city_type": "Domestic",
      "designation": "Software Developer",
      "description": "very nice job",
      "is_description_pdf": true,
      "compensation_CTC": 1200000,
      "compensation_gross": 1100000,
      "compensation_take_home": 1000000,
      "compensation_bonus": 10000,
      "compensation_details": "very good compensation",
      "is_compensation_details_pdf": true,
      "bond_details": "nil",
      "selection_procedure_rounds": [
        "Resume Shortlisting",
        "Technical Interview",
        "HR Interview"
      ],
      "selection_procedure_details": "All rounds are complusory",
      "is_selection_procedure_details_pdf": true,
      "tier": "4",
      "tentative_date_of_joining": "2022-01-15",
      "allowed_batch": ["2018", "2019"],
      "allowed_branch": ["CSE", "EE"],
      "tentative_no_of_offers": 5,
      "other_requirements": "above 8 cpi",
      "additional_info": ["School", "Home Town"],
      "email_verified": false,
      "offer_accepted": null,
      "deadline_date": "2021-12-04",
      "created_at": "2021-12-02T20:12:21+05:30"
    }
  ],
  "ongoing": [
    {
      "id": "Q54IRZZMC3RP8F6",
      "company_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FI5U4RDTV0OP0EM0_2019+Student+Details+-+Total%28State+Sort%29+-+Copy.pdf",
          "name": "I5U4RDTV0OP0EM0_2019 Student Details - Total(State Sort) - Copy.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FW04JWWNNMIBX0JX_2019+Student+Details+-+Total%28State+Sort%29.pdf",
          "name": "W04JWWNNMIBX0JX_2019 Student Details - Total(State Sort).pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FT1BXP98WBT9BHOR_AP0313017732021LL-Driving+Licence+-+Copy.pdf",
          "name": "T1BXP98WBT9BHOR_AP0313017732021LL-Driving Licence - Copy.pdf"
        }
      ],
      "description_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FC78TE2Z67BPZ41O_CSE-V-SEM.pdf",
          "name": "C78TE2Z67BPZ41O_CSE-V-SEM.pdf"
        }
      ],
      "compensation_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2F8D5OFQ46H43DD3S_module5And6Attendance.pdf",
          "name": "8D5OFQ46H43DD3S_module5And6Attendance.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FG8OU2PE919PFKSR_Print+Application11.pdf",
          "name": "G8OU2PE919PFKSR_Print Application11.pdf"
        }
      ],
      "selection_procedure_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FDZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_",
          "name": "DZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FN490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3",
          "name": "N490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3"
        }
      ],
      "company_name": "Make My Trip",
      "address": "MakeMyTrip India Pvt. Ltd.5, Awagarh House, MG Road(next to Bachoomal collections)Agra (UP), - 282002India",
      "company_type": "Private Sector",
      "nature_of_business": "Technology",
      "website": "www.makemytrip.com",
      "company_details": "This s a very nice company",
      "is_company_details_pdf": true,
      "contact_person_name": "Gowtham",
      "phone_number": 9390291911,
      "email": "saisurya3127@gmail.com",
      "city": "Mumbai",
      "state": "Maharashtra",
      "country": "India",
      "pin_code": 530013,
      "city_type": "Domestic",
      "designation": "Software Developer",
      "description": "very nice job",
      "is_description_pdf": true,
      "compensation_CTC": 1200000,
      "compensation_gross": 1100000,
      "compensation_take_home": 1000000,
      "compensation_bonus": 10000,
      "compensation_details": "very good compensation",
      "is_compensation_details_pdf": true,
      "bond_details": "nil",
      "selection_procedure_rounds": [
        "Resume Shortlisting",
        "Technical Interview",
        "HR Interview"
      ],
      "selection_procedure_details": "All rounds are complusory",
      "is_selection_procedure_details_pdf": true,
      "tier": "4",
      "tentative_date_of_joining": "2022-01-15",
      "allowed_batch": ["2018", "2019"],
      "allowed_branch": ["CSE", "EE"],
      "tentative_no_of_offers": 5,
      "other_requirements": "above 8 cpi",
      "additional_info": ["School", "Home Town"],
      "email_verified": false,
      "offer_accepted": null,
      "deadline_date": "2021-12-04",
      "created_at": "2021-12-02T20:12:21+05:30"
    }
  ],
  "previous": [
    {
      "id": "Q74IRZZMC3RP8F6",
      "company_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FI5U4RDTV0OP0EM0_2019+Student+Details+-+Total%28State+Sort%29+-+Copy.pdf",
          "name": "I5U4RDTV0OP0EM0_2019 Student Details - Total(State Sort) - Copy.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FW04JWWNNMIBX0JX_2019+Student+Details+-+Total%28State+Sort%29.pdf",
          "name": "W04JWWNNMIBX0JX_2019 Student Details - Total(State Sort).pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FT1BXP98WBT9BHOR_AP0313017732021LL-Driving+Licence+-+Copy.pdf",
          "name": "T1BXP98WBT9BHOR_AP0313017732021LL-Driving Licence - Copy.pdf"
        }
      ],
      "description_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FC78TE2Z67BPZ41O_CSE-V-SEM.pdf",
          "name": "C78TE2Z67BPZ41O_CSE-V-SEM.pdf"
        }
      ],
      "compensation_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2F8D5OFQ46H43DD3S_module5And6Attendance.pdf",
          "name": "8D5OFQ46H43DD3S_module5And6Attendance.pdf"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FG8OU2PE919PFKSR_Print+Application11.pdf",
          "name": "G8OU2PE919PFKSR_Print Application11.pdf"
        }
      ],
      "selection_procedure_details_pdf_links": [
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FDZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_",
          "name": "DZTQQ6YBGBQ47PY_screencapture-onlinesbi-sbi-sbicollect-fsssuccessresponseredirect-htm-2021-07-19-18_"
        },
        {
          "link": "https://storage.googleapis.com/cdc-backend-attachments/company_attachments/Q54IRZZMC3RP8F6%2FN490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3",
          "name": "N490PUXJEEN4JZ9_screencapture-onlinesbi-sbi-sbicollect-payment-suvidhapayment-htm-2021-07-19-23_12_3"
        }
      ],
      "company_name": "Make My Trip",
      "address": "MakeMyTrip India Pvt. Ltd.5, Awagarh House, MG Road(next to Bachoomal collections)Agra (UP), - 282002India",
      "company_type": "Private Sector",
      "nature_of_business": "Technology",
      "website": "www.makemytrip.com",
      "company_details": "This s a very nice company",
      "is_company_details_pdf": true,
      "contact_person_name": "Gowtham",
      "phone_number": 9390291911,
      "email": "saisurya3127@gmail.com",
      "city": "Mumbai",
      "state": "Maharashtra",
      "country": "India",
      "pin_code": 530013,
      "city_type": "Domestic",
      "designation": "Software Developer",
      "description": "very nice job",
      "is_description_pdf": true,
      "compensation_CTC": 1200000,
      "compensation_gross": 1100000,
      "compensation_take_home": 1000000,
      "compensation_bonus": 10000,
      "compensation_details": "very good compensation",
      "is_compensation_details_pdf": true,
      "bond_details": "nil",
      "selection_procedure_rounds": [
        "Resume Shortlisting",
        "Technical Interview",
        "HR Interview"
      ],
      "selection_procedure_details": "All rounds are complusory",
      "is_selection_procedure_details_pdf": true,
      "tier": "4",
      "tentative_date_of_joining": "2022-01-15",
      "allowed_batch": ["2018", "2019"],
      "allowed_branch": ["CSE", "EE"],
      "tentative_no_of_offers": 5,
      "other_requirements": "above 8 cpi",
      "additional_info": ["School", "Home Town"],
      "email_verified": false,
      "offer_accepted": null,
      "deadline_date": "2021-12-04",
      "created_at": "2021-12-02T20:12:21+05:30"
    }
  ]
}

• action: Tells us about the message creator
  
• message: Tells us what happened with our Request.
• ongoing: Gives us the list of placements that are accepting applications.
• previous: Gives us the list of placements that stopped accepting applications.
• new : Gives us the list of placements that is not yet accepeted by CDC.

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	Data Found
400 BAD_REQUEST	Something Went Wrong

You can see some common errors here

---

api/admin/updateDeadline

This Api is used to update deadline for a specific placement.

How to Use?

Send a POST request to api/admin/updateDeadline
Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6",
  "deadline_datetime": "2021-12-06 16:28:18 +0530"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Update Deadline",
  "message": "Deadline Updated"
}

• 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	Deadline Updated
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/updateOfferAccepted

This Api is used to update offer verification state for a specific placement.

How to Use?

Send a POST request to api/admin/updateOfferAccepted
Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6",
  "offer_accepted": "true"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Update Offer Accepted",
  "message": "Offer Accepted Updated"
}

• 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	Update Offer Accepted
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/updateEmailVerified

This Api is used to update email verification state for a specific placement.

How to Use?

Send a POST request to api/admin/updateEmailVerified
Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6",
  "email_verified": "false"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Update Email Verified",
  "message": "Email Verified Updated"
}

• 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	Email Verified Updated
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/updateAdditionalInfo

This Api is used to update additional_info for a specific placement.

How to Use?

Send a POST request to api/admin/updateAdditionalInfo
Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6",
  "additional_info": ["School", "Place of Living", "Research Interests"]
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Update Additional Info",
  "message": "Additional Info Updated"
}

• 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	Additional Info Updated
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/getApplications

This api is used to fetch all the applications applied by students for all placements

How to Use?

Send a POST request to api/admin/getApplications
Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Get Applications",
  "message": "Data Found",
  "applications": [
    {
      "id": "200010021",
      "student_details": {
        "id": "200010021",
        "resume_list": [
          {
            "link": "http://localhost/storage/Resumes/200010021/resume_link",
            "name": "resume_link"
          }
        ],
        "offers": [
          {
            "designation": "sde",
            "company_name": "JP Morgan",
            "application_id": "200010021",
            "placement_offer_type": "Normal"
          }
        ],
        "roll_no": 200010021,
        "name": "John",
        "batch": "2020",
        "branch": "CSE",
        "phone_number": 8105699450,
        "cpi": "9.00",
        "can_apply": true
      },
      "resume_link": {
        "link": "http://localhost/storage/Resumes/200010021/resume_links",
        "name": "resume_links"
      },
      "additional_info": null,
      "selected": true,
      "applied_at": "2022-05-30T19:15:33+05:30",
      "updated_at": "2022-05-30T19:16:31.662929+05:30",
      "student": "200010021"
    }
  ]
}

• 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	Data Found
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/submitApplication

This api is used to submit a students application

Request_Body:

{
  "applications_id": "F28IRGGMC3RP8Y8",
  "student_id": "200010022",
  "opening_id": "Q54IRZZMC3RP8F6",
  "additional_info": {
    "School": "Lions International",
    "City": "Banglore"
  },
  "resume_file_name": "8KIOT3PW1JIS718_CSE-V-SEM.pdf"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Add Student Application",
  "message": "Application Added"
}

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	Application Added
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/generateCSV

This api is used to generate a CSV file that contains sequential details of all the applications

Request_Body:

{
  "opening_id": "Q54IRZZMC3RP8F6"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields

{
  "action": "Create CSV",
  "message": "CSV Created",
  "file": "csv_file_link"
}

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	CSV created
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/addPPO

This api is used to add a PPO for a student in the corresponding company

Request_Body:

{
  "company_name": "Geeks for Geeks",
  "compensation_gross": "1000000",
  "offer_accepted": "true",
  "student_id": "200010022",
  "designation": "Technical Content Writer",
  "tier": "4"
}

Response

Response is a Json with these fields

{
  "action": "Add PPO",
  "message": "PPO Added"
}

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	PPO Added
400 BAD_REQUEST	Something Went Wrong

You may see some different errors which can be seen here

---

api/admin/getStudentApplication

This api is used to fetch the application details of the required student

Request_Body:

{
  "student_id": "200010022",
  "opening_id": "Q54IRZZMC3RP8F6"
}

Headers
Authorization: "Bearer {tokenID}"

Response

Response is a Json with these fields when the application is found.

{
  "action": "Get Student Application",
  "application_found": "true",
  "application_info": {
    "id": "F28IRGGMC3RP8Y8",
    "additional_info": {
      "12th grade": "9.1",
      "current GPA": "9.6"
    },
    "resume": "resume_link"
  },
  "student_details": {
    "name": "John",
    "batch": "2020",
    "branch": "MMAE",
    "resume_list": {
      "link": "http://localhost/storage/Resumes/200010021/resume_links",
      "name": "resume_link"
    }
  }
}

Response is a Json with these fields when the applciation is not found.

{
  "action": "Get Student Application",
  "application_found": "false",
  "student_details": {
    "name": "John",
    "batch": "2020",
    "branch": "MMAE",
    "resume_list": {
      "link": "http://localhost/storage/Resumes/200010021/resume_links",
      "name": "resume_link"
    }
  }
}

Status Codes

The possible responses for this api request are as follows

Status Codes	Possible Messages
200 OK	``
400 BAD_REQUEST	Something Went Wrong
404 NOT_FOUND	Application not found

You may see some different errors which can be seen here

---

Company Portal APIs

api/company/addPlacement/

This Api is used to add placements.

How to Use?

Send a POST request to api/company/addPlacement

Request_Body:

{
  "company_name": ["Make My Trip"],
  "address": [
    "MakeMyTrip India Pvt. Ltd.\n5, Awagarh House, MG Road\n(next to Bachoomal collections)\nAgra (UP), - 282002\nIndia"
  ],
  "company_type": ["Private Sector"],
  "nature_of_business": ["Technology"],
  "website": ["www.makemytrip.com"],
  "company_details": ["This s a very nice company"],
  "is_company_details_pdf": ["true"],
  "contact_person_name": ["Gowtham"],
  "phone_number": ["9390291911"],
  "email": ["saisurya3127@gmail.com"],
  "city": ["Mumbai"],
  "state": ["Maharashtra"],
  "country": ["India"],
  "pincode": ["530013"],
  "designation": ["Software Developer"],
  "description": ["very nice job"],
  "is_description_pdf": ["true"],
  "compensation_ctc": ["1200000"],
  "compensation_gross": ["1100000"],
  "compensation_take_home": ["1000000"],
  "compensation_bonus": ["10000"],
  "compensation_details": ["very good compensation"],
  "is_compensation_details_pdf": ["true"],
  "bond_details": ["nil"],
  "selection_procedure_rounds": [
    "['Resume Shortlisting', 'Technical Interview', 'HR Interview']"
  ],
  "selection_procedure_details": ["All rounds are complusory"],
  "is_selection_procedure_details_pdf": ["true"],
  "tentative_date_of_joining": ["15-01-2022"],
  "allowed_branch": ["['CSE', 'EE']"],
  "tentative_no_of_offers": ["5"],
  "other_requirements": ["above 8 cpi"],
  "company_details_pdf": ["__FILE_OBJECT__", "__FILE_OBJECT__"],
  "description_pdf": ["__FILE_OBJECT__"],
  "compensation_details_pdf": ["__FILE_OBJECT__"],
  "selection_procedure_details_pdf": ["__FILE_OBJECT__", "__FILE_OBJECT__"]
}

Response

Response is a Json with these fields

{
  "action": "Add Placement",
  "message": "Placement Added Successfully"
}

Headers
Authorization: "Bearer {tokenID}"

• 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	Placement Added Successfully
404 NOT FOUND	Something went wrong

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	Any random Error which can be seen in the {error} string.
400 BAD_REQUEST	Something went wrong	Any random Error which can be seen in the {error} string.