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.

HTTP GET to Monster's Power BGW URL: https://gateway.monster.com:443/bgwPower
SOAP envelope information can be found at: https://schemas.xmlsoap.org/soap/envelope
The header information can be found at https://schemas.monster.com/Current/XSD/MonsterHeader.XSD
- The header requires a CAT for submission. Information on authenticating by a CAT can be found at: https://schemas.monster.com/Current/XSd/AuthenticateByCompanyAccessTicket.xsd
Schema location attribute (optional)
- Monster's namespace instance is described at: https://www.w3.org/2001/XMLSchema-instance
The body of the request
- For PRIVATE resume board, the body information for retrieving jobseeker plus resume can be found at https://schemas.monster.com/Current/XSD/JobSeeker.xsd
- For PRIVATE resume board (PRDBX), the body information for retrieving only base-64 encoded resume document can be found at https://schemas.monster.com/Current/XSD/Document.xsd

Sample XML Resume Request

<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/">
 <SOAP-ENV:Header>
  <mh:MonsterHeader xmlns:mh="https://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="https://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="https://schemas.monster.com/Monster" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
   <TextResumeID>8qw3435345bh2w</TextResumeID>
   <ChannelAlias>PRS00011222333</ChannelAlias>
  </GetJobSeekerByTextResumeIDChannelAlias>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

GetJobSeeker

GetJobSeekerByTextResumeIDChannelAlias
< GetJobSeekerByTextResumeIDChannelAlias xmlns= https://schemas.monster.com/Monster xmlns:xsi=https://www.w3.org/2001/XMLSchema-instance
 xsi:schemaLocation="https://schemas.monster.com/Monster https://schemas.monster.com/Current/xsd/Monster.xsd">
<TextResumeID>j94val123samplek<</TextResumeID>
<ChannelAlias>PRS999999</ChannelAlias>
<RenderedResume>true</RenderedResume>
</ GetJobSeekerByTextResumeIDChannelAlias">

GetJobSeekerByResumeRefCode
< GetJobSeekerByResumeRefCode xmlns= https://schemas.monster.com/Monster xmlns:xsi=https://www.w3.org/2001/XMLSchema-instance 
xsi:schemaLocation="https://schemas.monster.com/Monster https://schemas.monster.com/Current/xsd/Monster.xsd">
<ResumeRefCode>Job_seeker_refcode<</ResumeRefCode>
<ChannelAlias>PRS999999</ChannelAlias>
<RenderedResume>true</RenderedResume>
</ GetJobSeekerByResumeRefCode>

GetJobSeekerAndDocumentByTextResumeIDChannelAlias
< GetJobSeekerAndDocumentByTextResumeIDChannelAlias xmlns= https://schemas.monster.com/Monster xmlns:xsi=https://www.w3.org/2001/XMLSchema-instance
 xsi:schemaLocation="https://schemas.monster.com/Monster https://schemas.monster.com/Current/xsd/Monster.xsd">
<TextResumeID>j94val123samplek<</TextResumeID>
<ChannelAlias>PRS999999</ChannelAlias>
<RenderedResume>true</RenderedResume>
</ GetJobSeekerAndDocumentByTextResumeIDChannelAlias">

GetJobSeekerAndDocumentByResumeRefCode

< GetJobSeekerAndDocumentByResumeRefCode xmlns= https://schemas.monster.com/Monster xmlns:xsi=https://www.w3.org/2001/XMLSchema-instance
 xsi:schemaLocation="https://schemas.monster.com/Monster https://schemas.monster.com/Current/xsd/Monster.xsd">
<ResumeRefCode>job_seeker_refcode<</ResumeRefCode>
<ChannelAlias>PRS999999</ChannelAlias>
</ GetJobSeekerAndDocumentByResumeRefCode">

DocumentQueryByTextResumeID

< DocumentQueryByTextResumeID xmlns= https://schemas.monster.com/Monster xmlns:xsi=https://www.w3.org/2001/XMLSchema-instance
 xsi:schemaLocation="https://schemas.monster.com/Monster https://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: https://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="https://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<MonsterHeader xmlns="https://schemas.monster.com/MonsterHeader">
<ChannelId xmlns="https://schemas.monster.com/MonsterHeader">58</ChannelId>
<MessageData>
<MessageId>30821924558799874222766_jweba205</MessageId>
<Timestamp>2014-08-23T17:27:34.434-04:00</Timestamp>
<RefToMessageId xmlns="https://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="https://schemas.xmlsoap.org/soap/envelope/">
<GetJobSeekerResponse xmlns="https://schemas.monster.com/Monster" xmlns:s="https://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://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>