Technical Overview

Development

Sample XML Resume Request

Response

Sample XML Resume Response

Cloud Search Resume Download

 

Technical Overview

Cloud Search Resume Download allows a client to use web services to retrieve job seeker resumes from their private database. 
 

Development

Client will be responsible for making the calls, in the sequence suggested in this guide, to Monster in order to successfully implement Cloud Search Resume Download. Within some sections there is a list of key points that clients need to be aware of and consider during development.

Key points to be aware of during development
  • All system calls to Monster are developed by the client.
  • Client is responsible for testing their implementation.
  • Resume retrieval is done against Monster's Power BGW URL: https://gateway.monster.com:443/bgwPower
  • A CAT is an encoded token, representing a user, that is used for authentication within a request to Monster web services.
  • The client's implementation must support multiple CAT's.
CLIENT calls Monster Business Gateway to request resume
The resume request is made up of a SOAP envelope, header and body. Below is some additional information on these sections of the resume request.
  1. HTTP GET to Monster's Power BGW URL: https://gateway.monster.com:443/bgwPower
  2. SOAP envelope information can be found at: http://schemas.xmlsoap.org/soap/envelope
  3. The header information can be found at http://schemas.monster.com/Current/XSD/MonsterHeader.XSD
  4. Schema location attribute (optional)
  5. The body of the request
 

Sample XML Resume Request

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<mh:MonsterHeader xmlns:mh="http://schemas.monster.com/MonsterHeader">
<mh:MessageData>
<mh:MessageId>Retrieve jobseeker and resume</mh:MessageId>
<mh:Timestamp>2014-08-29T14:41:44Z</mh:Timestamp> </mh:MessageData>
</mh:MonsterHeader>
<wsse:Security xmlns:wsse="http://schemas.xmlsoap.org/ws/2002/04/secext">
<wsse:UsernameToken>
<wsse:Username>USERNAME</wsse:Username>
<wsse:Password>PASSWORD</wsse:Password> </wsse:UsernameToken>
</wsse:Security>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<GetJobSeekerByTextResumeIDChannelAlias xmlns="http://schemas.monster.com/Monster" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<TextResumeID>8qw3435345bh2w</TextResumeID>
<ChannelAlias>PRS00011222333</ChannelAlias>
</GetJobSeekerByTextResumeIDChannelAlias>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
 

GetJobSeeker

GetJobSeekerByTextResumeIDChannelAlias
< GetJobSeekerByTextResumeIDChannelAlias xmlns= http://schemas.monster.com/Monster xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation="http://schemas.monster.com/Monster http://schemas.monster.com/Current/xsd/Monster.xsd"> <TextResumeID>j94val123samplek<</TextResumeID> <ChannelAlias>PRS999999</ChannelAlias> <RenderedResume>true</RenderedResume> </ GetJobSeekerByTextResumeIDChannelAlias"> GetJobSeekerByResumeRefCode
< GetJobSeekerByResumeRefCode xmlns= http://schemas.monster.com/Monster xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation="http://schemas.monster.com/Monster http://schemas.monster.com/Current/xsd/Monster.xsd"> <ResumeRefCode>Job_seeker_refcode<</ResumeRefCode> <ChannelAlias>PRS999999</ChannelAlias> <RenderedResume>true</RenderedResume> </ GetJobSeekerByResumeRefCode> GetJobSeekerAndDocumentByTextResumeIDChannelAlias
< GetJobSeekerAndDocumentByTextResumeIDChannelAlias xmlns= http://schemas.monster.com/Monster xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation="http://schemas.monster.com/Monster http://schemas.monster.com/Current/xsd/Monster.xsd"> <TextResumeID>j94val123samplek<</TextResumeID> <ChannelAlias>PRS999999</ChannelAlias> <RenderedResume>true</RenderedResume> </ GetJobSeekerAndDocumentByTextResumeIDChannelAlias"> GetJobSeekerAndDocumentByResumeRefCode
< GetJobSeekerAndDocumentByResumeRefCode xmlns= http://schemas.monster.com/Monster xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation="http://schemas.monster.com/Monster http://schemas.monster.com/Current/xsd/Monster.xsd"> <ResumeRefCode>job_seeker_refcode<</ResumeRefCode> <ChannelAlias>PRS999999</ChannelAlias> </ GetJobSeekerAndDocumentByResumeRefCode"> DocumentQueryByTextResumeID
< DocumentQueryByTextResumeID xmlns= http://schemas.monster.com/Monster xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:schemaLocation="http://schemas.monster.com/Monster http://schemas.monster.com/Current/xsd/Monster.xsd"> <TextResumeID>j94val123samplek<</TextResumeID> <ChannelAlias>PRS999999<</ChannelAlias> </ DocumentQueryByTextResumeID">

Note
 
  • Resumes can only be retrieved one at a time. Attempting to retrieve multiple resumes at a time will cause "Transport https does not allow payload" errors. Therefore, limit your request only one resume per SOAP query.

RESPONSE XML received from Monster

The resume returned will be in the following format: http://schemas.monster.com/Current/XSD/JobSeeker.
  • If a failure happens during the resume retrieval process, the client system shall take the appropriate action and re-attempt resume retrieval some time in the future.
  • It is recommended that the client automatically track the resume source.
  • For troubleshooting purposes, it is highly recommended that the MessageId in the response be stored on the client side.
 

Sample XML Resume Response

(Click to Sample XML Resume Response)
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<MonsterHeader xmlns="http://schemas.monster.com/MonsterHeader">
<ChannelId xmlns="http://schemas.monster.com/MonsterHeader">58</ChannelId>
<MessageData>
<MessageId>30821924558799874222766_jweba205</MessageId>
<Timestamp>2014-08-23T17:27:34.434-04:00</Timestamp>
<RefToMessageId xmlns="http://schemas.monster.com/MonsterHeader">Company Jobs created on 06/09/2004 02:41:44 PM</RefToMessageId>
</MessageData>
</MonsterHeader>
</SOAP-ENV:Header>
<SOAP-ENV:Body xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<GetJobSeekerResponse xmlns="http://schemas.monster.com/Monster" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Descriptions/> <JobSeekers> <JobSeeker seekerId="11111111" seekerScope= "normal" status="active"> <Channel alias="CHAN" monsterId="1111">CHANNEL NAME</Channel > <PersonalData> <Contact> <StructuredName> <GivenName> test First Name/<GivenName> <MiddleName/> <FamilyName> test First Name/<FamilyName> </StructuredName> <Address> <StreetAddress> test Home Address/<StreetAddress> <StreetAddress2> test Home Address/<StreetAddress2> <City> Praha/<City> <State> PRAG</State> <CountryCode> CZ</CountryCode> <PostalCode> 1411</PostalCode> </Address> <Phones> <Phone phoneType="work" priority="primary">0123456789 </Phone > <Phone phoneType="mobile" priority="secondary">987654321 </Phone > </Phones> <E-mail>test_email@monster.com</E-mail> </Contact> </PersonalData> <Account> <Confidential>0</Confidential> </Account> <Profile> <CareerLevel monsterId="12">Experienced (Non-Manager) </Channel /> <Availability> <AvailableTimeStart monsterId ="1">Immediately </AvailableTimeStart /> </Availability> <ContactPreference monsterId="0"> <TotalYearsWorkExperience monsterId="6">10+ to 15 Years </TotalYearsWorkExperience /> <HighestEducationDegree monsterId="6">Master's Degree </HighestEducationDegree /> <TargetJobTitle> <Title>MPS</Title> <OccupationalClassification occupationId="101521"> </TargetJobTitle> </Profile> <Resumes> <Resume textResumeId="ababababababab"> <BoardName monsterId="1">Monster </BoardName /> <ResumeTitle>Monster test resume title</ResumeTitle> <ResumeModDate>2014-02-11T09:46:00-05:00</ResumeModDate> <ResumeCreateDate>2011-12-11T08:01:00-05:00</ResumeCreateDate> <DetailedSearchExtras> <WillingToRelocate>true</WillingToRelocate> <JobStatus monsterId="4">Full Time</JobStatus> <JobType monsterId="1">WantsPermanent<</JobType> <JobType monsterId="2">WantsContract<</JobType> <JobType monsterId="4">WantsTemp</JobType> <GeographicPrefs> <GeographicPref> <CountryCode>FR</CountryCode> <Continent>EU</Continent> </GeographicPref> <GeographicPrefs> <CountryCode>US</CountryCode> <Continent>NA</Continent> </GeographicPref> <GeographicPrefs> </DetailedSearchExtras> <WorkAuthorizations> <WorkAuthorization> <AuthStatus monsterId="1">I am authorized to work in this country for any employer.</AuthStatus> <CountryCode>France</CountryCode> </WorkAuthorization> <WorkAuthorization> <AuthStatus monsterId="1">I am authorized to work in this country for any employer.</AuthStatus> <CountryCode>US</CountryCode> </WorkAuthorization> </WorkAuthorizations> <DesiredCompensation> <CompensationType monsterId="1">Per Year</CompensationType> <Currency monsterId="1">USD</Currency> <Rate>60000</Rate> </DesiredCompensation> <DesiredEmployer> <TargetEmployerCategories> <TargetEmployerCategory monsterId="660">IT/Software Development</TargetEmployerCategory> </TargetEmployerCategories> <TargetEmployerOccupations> <TargetEmployerOccupation categoryId="660"monsterId="11754"> <Name>Computer/Network Security </Name> </TargetEmployerOccupation> <TargetEmployerOccupation categoryId="660"monsterId="11787"> <Name>Enterprise Software Implementation & Consulting</Name> </TargetEmployerOccupation> <TargetEmployerOccupation categoryId="660"monsterId="11969"> <Name>Software/System Architecture</Name> </TargetEmployerOccupation> </TargetEmployerOccupation> </TargetEmployerOccupations> <TargetJobIndustries> <Industry> <IndustryName monsterId="8">Biotechnology/Pharmaceuticals</IndustryName> </Industry> <Industry> <IndustryName monsterId="29">Advertising and PR Services</IndustryName> </Industry> <Industry> <IndustryName monsterId="30">Architectural and Design Services</IndustryName> </Industry> </TargetJobIndustries> </DesiredEmployer> <TargetJobTitles> <TargetJobTitlestype="desired"> <Title>test Job Title1</Title> </TargetJobTitle> <TargetJobTitles type="alternate"> <Title>test Job Title 2</Title> </TargetJobTitle> </TargetJobTitles> <EmploymentHistory> <Position monsterId="280889215"> <EmployerName>test Most Recent Job Title</EmployerName> <PositionTitle>test Most Recent Job Title</PositionTitle> <EmploymentLocation>,</EmploymentLocation> <IndustryName monsterId="0">All</IndustryName> </ExperienceIndustry> </Position> </EmploymentHistory> <WorkPreferences> <Weekend monsterId="0">No</IndustryName> <Overtime>false</Overtime> </WorkPreferences> <TextResume>Resume Test Body</TextResume> <Weekend monsterId="4"/> <Channel alias="CHAN" monsterId="4425">CHANNEL</CHANNEL> </Resume> </Resumes> <CustomQuestions customQuestionId="1144" displaySequence="1" > <CQInternalPromptText>P/L Experience</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1145" displaySequence="2" > <CQInternalPromptText>Largest Budget Managed</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1146" displaySequence="3" > <CQInternalPromptText># of People Managed</CQInternalPromptText> <CustomQuestions customQuestionId="1147" displaySequence="4" > <CQInternalPromptText>Turn-Around Experience</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1148" displaySequence="5" > <CQInternalPromptText>Turn-Around ExperienceAccomplishments</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1149" displaySequence="6" > <CQInternalPromptText>IPO Experience</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1150" displaySequence="7" > <CQInternalPromptText>IPO Experience Accomplishments</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1151" displaySequence="8" > <CQInternalPromptText>Start-up Experience</CQInternalPromptText> </CustomQuestion> </CustomQuestion> <CustomQuestions customQuestionId="1152" displaySequence="9" > <CQInternalPromptText>Start-up Experience Accomplishments</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1153" displaySequence="10" > <CQInternalPromptText>Mergers & Acquisitions</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1154" displaySequence="11" > <CQInternalPromptText>Mergers & Acquisitions</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1155" displaySequence="12" > <CQInternalPromptText>Entrepreneurial Experience</CQInternalPromptText> </CustomQuestion> <CustomQuestions customQuestionId="1156" displaySequence="13" > <CQInternalPromptText>Entrepreneurial Experience Accomplishments</CQInternalPromptText> </CustomQuestion> </CustomQuestions> </JobSeeker> </JobSeekers> </QueriesResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>