findByListNameAndParentId
Retrieves the elements of a list of values with a given parent id element. This values can be used for posting a job offer or to retrieve the value of some CV fields. For example, you can get all the possible provinces of a given country.
Request
WSDL Production URL
https://api.infojobs.[net|it]/soap/WSListOfValuesService?wsdl
WSDL Testing URL
https://api.infojobssbx.[net|it]/soap/WSListOfValuesService?wsdl
Security
- User Role: PUBLIC
Parameters
| Name | Description |
|---|---|
|
publicNameKey String Required |
The name that identifies the list of values. The available publicNameKey with parent elements are: DETAILSTUDIES: The parent list of values is the level of education. Parent publicKeyName: STUDIESLEVEL PROVINCES: The parent list of values is the country where the province is located. Parent publicKeyName: COUNTRIES SUBCATEGORIES: The parent list of values is the industry type. Parent publicNameKey: CATEGORIES Example values: PROVINCES |
|
parentId Long Required |
The identifier of the parent item. In order to obtain all valid identifiers you can use the operation findByListName providing the publicNameKey of the parent list of values.
Example values: 17 (Spain)
|
Response
Response entities
Returns a list with the values for the requested publicNameKey and parentId. For each item it returns the following fields:
| Name | Description |
|---|---|
|
id |
Identifier of the element. |
|
valor |
Human readable textual value. |
|
order |
Order of the element in the list. |
Error codes
| Code | Description |
|---|---|
|
WS.150 |
Expired access token |
|
WS.152 |
Access Token is required |
|
WS.153 |
Access token not authorized for this operation |
|
WS.154 |
Invalid access token |
|
WS.155 |
Invalid access token |
|
WS.156 |
Wrong access token |
|
WS.3000 |
Missing required parameter. |
|
WS.3001 |
The parameter publicNameKey is not a valid list of values. |
|
WS.3002 |
The parentId is not valid for the requested list of values. |
Examples
This example returns the provinces with parent 17 (Spain). Using the parameters publicNameKey: PROVINCES parentId: 17
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:lis="http://listOfValues.service.ws.infojobs.net/">
<soapenv:Header>
<wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsse:UsernameToken wsu:Id="UsernameToken-799830164" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsse:Username>SOAP-TEST</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SOAP-TEST-SECRET</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
<ij:authnHeader xmlns:ij='http://api.infojobs.net/soap/authn'>
<token>20000000-0000-0000</token>
</ij:authnHeader>
</soapenv:Header>
<soapenv:Body>
<lis:findByListNameAndParentId>
<publicNameKey>PROVINCES</publicNameKey>
<parentId>17</parentId>
</lis:findByListNameAndParentId>
</soapenv:Body>
</soapenv:Envelope>
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<wsse:Security soap:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsu:Timestamp wsu:Id="TS-4">
<wsu:Created>2012-05-07T10:33:48.990Z</wsu:Created>
<wsu:Expires>2012-05-07T10:38:48.990Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</soap:Header>
<soap:Body>
<ns1:findByListNameAndParentIdResponse xmlns:ns1="http://listofvalues.endpoints.www.soap.infojobs.net/">
<listOfValues>
<items>
<id>0</id>
<orden>0</orden>
<valor>(Seleccionar)</valor>
</items>
<items>
<id>28</id>
<orden>1</orden>
<valor>A Coruña</valor>
</items>
<items>
<id>2</id>
<orden>2</orden>
<valor>Álava</valor>
</items>
<items>
<id>3</id>
<orden>3</orden>
<valor>Albacete</valor>
</items>
<items>
<id>4</id>
<orden>4</orden>
<valor>Alicante/Alacant</valor>
</items>
<items>
<id>5</id>
<orden>5</orden>
<valor>Almería</valor>
</items>
<items>
<id>6</id>
<orden>6</orden>
<valor>Asturias</valor>
</items>
<items>
<id>7</id>
<orden>7</orden>
<valor>Ávila</valor>
</items>
<items>
<id>8</id>
<orden>8</orden>
<valor>Badajoz</valor>
</items>
<items>
<id>9</id>
<orden>9</orden>
<valor>Barcelona</valor>
</items>
<items>
<id>10</id>
<orden>10</orden>
<valor>Burgos</valor>
</items>
<items>
<id>11</id>
<orden>11</orden>
<valor>Cáceres</valor>
</items>
<items>
<id>12</id>
<orden>12</orden>
<valor>Cádiz</valor>
</items>
<items>
<id>13</id>
<orden>13</orden>
<valor>Cantabria</valor>
</items>
<items>
<id>14</id>
<orden>14</orden>
<valor>Castellón/Castelló</valor>
</items>
<items>
<id>15</id>
<orden>15</orden>
<valor>Ceuta</valor>
</items>
<items>
<id>16</id>
<orden>16</orden>
<valor>Ciudad Real</valor>
</items>
<items>
<id>17</id>
<orden>17</orden>
<valor>Córdoba</valor>
</items>
<items>
<id>18</id>
<orden>18</orden>
<valor>Cuenca</valor>
</items>
<items>
<id>19</id>
<orden>19</orden>
<valor>Girona</valor>
</items>
<items>
<id>21</id>
<orden>20</orden>
<valor>Granada</valor>
</items>
<items>
<id>22</id>
<orden>21</orden>
<valor>Guadalajara</valor>
</items>
<items>
<id>23</id>
<orden>22</orden>
<valor>Guipúzcoa</valor>
</items>
<items>
<id>24</id>
<orden>23</orden>
<valor>Huelva</valor>
</items>
<items>
<id>25</id>
<orden>24</orden>
<valor>Huesca</valor>
</items>
<items>
<id>26</id>
<orden>25</orden>
<valor>Illes Balears</valor>
</items>
<items>
<id>27</id>
<orden>26</orden>
<valor>Jaén</valor>
</items>
<items>
<id>29</id>
<orden>27</orden>
<valor>La Rioja</valor>
</items>
<items>
<id>20</id>
<orden>28</orden>
<valor>Las Palmas</valor>
</items>
<items>
<id>30</id>
<orden>29</orden>
<valor>León</valor>
</items>
<items>
<id>31</id>
<orden>30</orden>
<valor>Lleida</valor>
</items>
<items>
<id>32</id>
<orden>31</orden>
<valor>Lugo</valor>
</items>
<items>
<id>33</id>
<orden>32</orden>
<valor>Madrid</valor>
</items>
<items>
<id>34</id>
<orden>33</orden>
<valor>Málaga</valor>
</items>
<items>
<id>35</id>
<orden>34</orden>
<valor>Melilla</valor>
</items>
<items>
<id>36</id>
<orden>35</orden>
<valor>Murcia</valor>
</items>
<items>
<id>37</id>
<orden>36</orden>
<valor>Navarra</valor>
</items>
<items>
<id>38</id>
<orden>37</orden>
<valor>Ourense</valor>
</items>
<items>
<id>39</id>
<orden>38</orden>
<valor>Palencia</valor>
</items>
<items>
<id>40</id>
<orden>39</orden>
<valor>Pontevedra</valor>
</items>
<items>
<id>41</id>
<orden>40</orden>
<valor>Salamanca</valor>
</items>
<items>
<id>46</id>
<orden>41</orden>
<valor>Santa Cruz de Tenerife</valor>
</items>
<items>
<id>42</id>
<orden>42</orden>
<valor>Segovia</valor>
</items>
<items>
<id>43</id>
<orden>43</orden>
<valor>Sevilla</valor>
</items>
<items>
<id>44</id>
<orden>44</orden>
<valor>Soria</valor>
</items>
<items>
<id>45</id>
<orden>45</orden>
<valor>Tarragona</valor>
</items>
<items>
<id>47</id>
<orden>46</orden>
<valor>Teruel</valor>
</items>
<items>
<id>48</id>
<orden>47</orden>
<valor>Toledo</valor>
</items>
<items>
<id>49</id>
<orden>48</orden>
<valor>Valencia/València</valor>
</items>
<items>
<id>50</id>
<orden>49</orden>
<valor>Valladolid</valor>
</items>
<items>
<id>51</id>
<orden>50</orden>
<valor>Vizcaya</valor>
</items>
<items>
<id>52</id>
<orden>51</orden>
<valor>Zamora</valor>
</items>
<items>
<id>53</id>
<orden>52</orden>
<valor>Zaragoza</valor>
</items>
</listOfValues>
</ns1:findByListNameAndParentIdResponse>
</soap:Body>
</soap:Envelope>
