CodeMunch / CodeMunch API Technical Documentation
FEEDBACK
Welcome to CodeMunch API - Let's Spread Real Time Career Innovation!
join codemunch
CodeMunch is a social recruitment platform which makes good use of emerging social networking technologies. By providing access to large database of universities, companies and learning tools, CodeMunch API will empower developers to create next generation career management applications.
CodeMunch API Technical Documentation:

Current version API supports following methods to send and receive CodeMunch data.

Job Posting: /job/new
Field Description
End Point http://www.codemunch.com/jobs/new.format
Supported Format XML, JSON
HTTP Method POST
Requires Authentication True
API Rate Limited True
Parameters
service_name Required. Twitter or facebook name for user who is posting job
service_provider Required. Twitter or Facebook
URL http://www.codemunch.com/jobs/new.format
Data Format -

						            <jobs>
									<job>
									<key></key>
									<service_name></service_name>
						            <service_provider></service_provider>
									<title>Sales</title>
						            <type>Sales</type>
						            <description>Sales job with great job plus great salary</description>
									<company></company>
									<company_url></company_url>
									<receive_resume></receive_resume>
									</job>
									
Response :
XML example:

														<?xml version="1.0" encoding="UTF-8"?>
															<jobs>

																<created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>

																<id>9</id>

																<title>Management Trainee </title>

																<type></type>  

																<description>Looking for candidates with MBA from reputed college and excellent academic profile.</description>

																<url>Job url like- http%3A%2F%2Fwww.codemunch.com%2Fmodule%2Fcareer-enhancer%2Fjob-detail.php%3Fid%3D%3D%3DAUUF0dZhFaaJlRaVXTWJVU%26job_id%3D30 </url>

																<shorturl>http://bit.ly/3bxQJT    or   http://ur.ly/3hc7  ( it can be bitly or urly  shorturl) </shorturl>

																<cm_id></cm_id>

																<cm_partnername></cm_partnername>

																<cm_location></cm_location>

													     </jobs>
													
Response code
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure
  500  - XML data formatting error
Job Delete: /job/delete
Field Description
End Point http://codemunch.com/jobs/delete/
Supported Format XML, JSON
HTTP Method(s) POST,DELETE
Requires Authentication True
API Rate Limited false
Parameters
id. Required. The ID of the job to delete.
URL http://codemunch.com/jobs/delete
Response :
XML example:
						         
						             <?xml version="1.0" encoding="UTF-8"?>
						                  <jobs> 
						               <status></status>
						                <created_at></created_at>
						                <id></id>
						                <title></title>
						               <type></type>
						                <description></description> 
						               </jobs>
						           
Response code
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure
Job List: /jobs/all_jobs
Returns the 20 most recent jobs from codemunch users .
Field Description
End Point http://www.codemunch.com/jobs/all_jobs.format
Supported Format XML, JSON
HTTP Method(s) GET
Requires Authentication false
API Rate Limited false
Response :
XML example:

						             <?xml version="1.0" encoding="UTF-8"?> 
						            <jobs>
						                <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at> 
						               <partnername>Apptility Software Pvt Ltd</partnername>
						                <tw_url>apptility</tw_url>   // Company twitter name 
						               <id>9</id>
						                <title>Management Trainee </title>
						               <type></type>
						                <description>Looking for candidates with MBA from reputed college and excellent academic profile.</description>
						                </jobs>
										
Response code
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure
 /jobs/show
Returns the 20 most recent jobs from a particular codemunch  partner/publisher.
Field Description
End Point http://www.codemunch.com/jobs/show/job_id.format
Supported Format XML, JSON
HTTP Method(s) GET
Requires Authentication True
API Rate Limited false
Parameters
job_id - Required. This is Job id for a job on CodeMunch.
URL http://wwww.codemunch.com/jobs/show/12345.xml.jobs
Response
XML example:
										

						             <?xml version="1.0" encoding="UTF-8"?> 
						            <jobs>
						               <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
						                <partnername>Apptility Software Pvt Ltd</partnername> 
						               <tw_url>apptility</tw_url>   // Company twitter name 
						               <id>9</id>
						                <title>Management Trainee </title>
						             <type></type>
						              <description>Looking for candidates with MBA from reputed college and excellent academic profile.</description>
						                </jobs>
						           
Response code :
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure
 /jobs/partner_jobs
Returns the 20 most recent jobs from a particular codemunch  partner/publisher.
Field Description
End Point http://www.codemunch.com/jobs/partner_jobs.format
Supported Format XML, JSON
HTTP Method(s) GET
Requires Authentication True
API Rate Limited false
Parameters
cm_id - Optional. This is CodeMunch id for companies.
URL http://www.codemunch.com/jobs/12345.xml. If user requests http://www.codemunch.com/jobs/partner_jobs.xml then he will get his own jobs
Response
XML example:
	
						         
						             <?xml version="1.0" encoding="UTF-8"?> 
						            <jobs> <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
						               <partnername>Apptility Software Pvt Ltd</partnername> 
						               <tw_url>apptility</tw_url>   // Company twitter name <id>9</id> 
						               <title>Management Trainee </title>
						             <type></type>
						                <description>Looking for candidates with MBA from reputed college and excellent academic profile.</description>
						                </jobs>
						          	
Response code :
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure

Job List Stats


 /jobs/stats/id   [COMING SOON]

Colleges API

 /college/getColleges_byCity
Returns the college(s) for the particular city .
Field Description
End Point http://www.codemunch.com/college/city/Bangalore.format
Supported Format XML, JSON
HTTP Method(s) GET
Requires Authentication false
API Rate Limited false
Parameters
city - This is city for colleges
URL http://www.codemunch.com/college/city/Bangalore.xml.
Response
XML example:
								
						             	<?xml version="1.0" encoding="UTF-8"?>
						                <college> 
						             	<id>1673</id>
						                <name>Alpha College of Engineering (ACE)</name>
						                <address>30/2, Doddagubbi Post</address>
						              	<city>Bangalore</city>
						              	<state>Karnataka</state>
						                <country>India</country>
						                <zipcode>562 149</zipcode> 
						             	<website>http://www.alphace.org</website>
						         		<twitter_url>alphace</twitter_url>
						                <facebook_url></facebook_url> 
						                <contact_email>principal@alphace.org</contact_email>
						            	<contact_number>080 2844 5218</contact_number> 
						                <contact_person></contact_person> 
						               <placement_website>http://www.acharya.ac.in/placement.php</placement_website> 
						               <admission_website>http://www.acharya.ac.in/admission.php</admission_website>
						                <affiliated_to>Karnataka Technical University</affiliated_to>
						                <accredited_by>NAAC B+</accredited_by>
						                <recognized_by>UGC</recognized_by>
						                <established_year>1965</established_year>
						              	</college>
						           
Response code :
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure
 /college/getColleges_byZipcode

Returns the college(s) for the particular Zip (Pin) Code .
Field Description
End Point http://www.codemunch.com/college/zipcode/209201.format
Supported Format XML, JSON
HTTP Method(s) GET
Requires Authentication false
API Rate Limited false
Parameters
zipcode - This is zipcode for colleges.
URL http://www.codemunch.com/college/zipcode/526149.xml
Response
XML example:
						         
						              <?xml version="1.0" encoding="UTF-8"?>
						              <college>
						              <id>1673</id>
						              <name>Alpha College of Engineering (ACE)</name>
						              <address>30/2, Doddagubbi Post</address>
						              <city>Bangalore</city>
						              <state>Karnataka</state>
						              <country>India</country> 
						              <zipcode>562 149</zipcode>
						              <website>http://www.alphace.org</website>
						              <twitter_url>alphace</twitter_url>
						              <facebook_url></facebook_url>
						              <contact_email>principal@alphace.org</contact_email> 
						              <contact_number>080 2844 5218</contact_number> 
						              <contact_person></contact_person>
						          	  <placement_website>http://www.acharya.ac.in/placement.php</placement_website> 
						              <admission_website>http://www.acharya.ac.in/admission.php</admission_website>
						              <affiliated_to>Karnataka Technical University</affiliated_to>
						              <accredited_by>NAAC B+</accredited_by> 
						              <recognized_by>UGC</recognized_by>
						              <established_year>1965</established_year>
						              </college>
						           
Response code :
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure
 /college/getCollegesDetail_byName
Returns the detail of the particular college.
Field Description
End Point http://www.codemunch.com/college/name/hbti.format
Supported Format XML, JSON
HTTP Method(s) GET
Requires Authentication false
API Rate Limited false
Parameters
College Name - This is name of the college.
URL http://www.codemunch.com/college/name/hbti.xml.
Response
XML example:
						             <?xml version="1.0" encoding="UTF-8"?>
						             <college> <id>4898</id>
						             <name>HBTI - Kanpur</name> 
						             <address>Nawabganj</address>
						             <city>Kanpur</city>
						             <state>Uttar Pradesh</state>
						             <country>India</country> 
						             <zipcode>562 149</zipcode>
						             <website>http://www.hbti.ac.in</website>
						             <twitter_url></twitter_url>   <facebook_url>
						             </facebook_url> <contact_email></contact_email>
						             <contact_number></contact_number> 
						             <contact_person></contact_person>
						             <placement_website></placement_website> 
						             <admission_website></admission_website>
						             <affiliated_to></affiliated_to>
						             <accredited_by></accredited_by> 
						             <recognized_by></recognized_by>
						             <established_year></established_year>
						             </college>
						           
Response code :
 
 200 - Success code
 400 - Bad Request and request should be not be sent without modification
 401 - Request is not authorized
 500 - Internal sever error in case of db operation failure


Join Google Group forum to discuss issues and ideas related to Codemunch API.