Occupation Keyword Search - CareerOneStop



CareerOneStop

Consumption Instructions: Get Occupation Certification List

Last Revised: October 19, 2010

Get Occupation Certification List

The Find Occupation Matches Service is a RESTful API that enables developers to query and retrieve a list of certifications. The returned CertificationInfo object contains certifications collected by the CareerOneStop program related to a given O*NET code. Refer to the following sections more specific information:

• Request Parameters

• Response Fields

• Errors

• Examples

Request Parameters

Refer to the following table for a list of the required and optional request parameters.  All parameter names and values are case sensitive.

Important: You must provide all required parameters. Submitting an empty request does not return all possible results; an empty request returns an error.

|Parameter |Required |Description |

|userid |Yes |This value is the unique user ID provided during the CareerOneStop web services registration|

| | |process. |

|onetcode |Yes |This is the O*NET code of the occupation to find matches for. e.g., Computer Programmers, |

| | |O*NET Code 15-1021.00 would be sent as “15102100.” |

Response Fields

The web service returns a XML serialized “CertificationInfo” with general information about the request and a list of matching job objects.

CertificationInfo Object

|Name |Description |

|ErrorMessage |If there was a problem processing the request a message describing the error is returned. If the |

| |request was completed without error “Success” is returned. |

|ErrorNumber |Refer Error Number & Description section for more information. |

|CertificationsDetails |Always returns null for this method |

|CertificationList |A collection of matching Certification objects. See Certification object below |

|OccupationList |A collection of certifying orgazations offering certifications related to the selected occupation. See|

| |ORG object below. |

|OnetTitle |O*NET occupation used in the search. See OnetTitle object below. |

Error Number & Description

|Error Number |Description |

|106 |No Location Information Found |

|105 |No Apprenticeship Found |

|104 |No Licenses Found |

|103 |No Certfications Found |

|102 |No Training Found |

|101 |No Occupation Matches Found |

|100 |No Jobs Found |

|0 |Success |

|-1 |Database Unavailable |

|-2 |Endeca Unavailable |

|-3 |Unknow Error |

|-4 |Invalid OnetCode |

|-5 |Invalid Zipcode |

|-6 |Invalid State |

|-7 |Job Central Not Available |

|-8 |Job Central TimedOut |

|-9 |Database Error |

|-10 |No Record Found |

|-11 |Invalid Number Format |

|-12 |Invalid Distance |

|-13 |Job Count is not available for {n} job(s) – (n is number) |

|-14 |Invalid State Or ZipCode |

|-15 |ASL Geocoding Webservice Down |

|-16 |Acinet Webservice Down |

Certification Object

|Name |Description |

|CERT_ID |CareerOneStop certification ID number |

|CERT_NAME |Name of the certification |

|CERT_TYPE |Certification type code (see CERT_TYPE_NAME) |

|CERT_TYPE_NAME |Certification type name |

|ORG_ID |CareerOneStop certifying organization ID number |

|ORG_NAME |Name of the certifying organization |

ORG Object

|Name |Description |

|ORG_ID |CareerOneStop certifying organization ID number |

|ORG_NAME |Name of the certifying organization |

OnetTitle Object

|Name |Description |

|ONETCODE |O*NET code used in the search |

|TITLE |O*NET Title |

General Web Service Errors (Returned in a standalone error node)

|[pic]Error |Description |

|“Invalid user ID” |The userid is not in the proper format. A user ID should be 15 alpha-numeric characters. |

|“Access to the Service Denied - This|This service has been suspended by CareerOneStop. |

|service has been suspended.” | |

|“Access to the Service Denied - This|This service has not yet become active or has expired. |

|service is not valid at this time.” | |

|“Access to the Service Denied - This|This service could not be found in CareerOneStop system. |

|service cannot be found.” | |

|“Access to the Service Denied - |This user’s usage limit for this service has been exceeded. |

|Usage limit exceeded.” | |

|“Access to the Service Denied - |This user’s subscription for this service has expired. |

|Subscription has expired.” | |

|“Access to the Service Denied - |This user’s subscription for this service has not yet become valid. |

|Subscription is not yet valid.” | |

|“Access to Service Denied - No valid|No subscription was found for this user ID and service. |

|subscription found.” | |

[pic]

Usage Example: Get Occupation Certification List

Use Case #1

A user would like to see certifications related to Machinists(O*NET Code: 51-4041.00).

Request Parameter Specifications

Refer to the following table for the parameters required to satisfy the use case above.

|Parameter |Value |

|userid |012345678901234 |

|onetcode |51404100 |

Request URL:



Refer to the following for an example (code example) of results for the request parameters specified above.

| |

|Success |

|0 |

| |

| |

| |

|3819 |

|Machining Level I - CNC Milling: Programming Setup & Operations |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3827 |

|Machining Level II - CNC Turning |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3831 |

|Machining Level III - CNC Milling |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0725 |

|Machining Level I - Manual Turning Between Centers |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3825 |

|Machining Level II - Manual Surface Grinding |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3820 |

|Machining Level I - CNC Turning: Programming Setup & Operations |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0719 |

|Machining Level I - Measurement, Materials and Safety Job |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3824 |

|Machining Level II - Cylindrical Grinding |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0720 |

|Machining Level I - Planning, Benchwork, and Layout |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|4883 |

|Certified Metalworking Fluids Specialist |

|A |

|Common |

|0466 |

|Society of Tribologists and Lubrication Engineers |

| |

| |

|3829 |

|Machining Level II - EDM - Plunge |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3830 |

|Machining Level III - CNC Turning |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0728 |

|Metalforming Level I |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0726 |

|Machining Level I - Manual Turning with Chucking |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3826 |

|Machining Level II - CNC Milling |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3828 |

|Machining Level II - EDM Wire |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3823 |

|Machining Level II - Manual Drill Press Operations |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3822 |

|Machining Level II - Manual Turning |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3836 |

|Slide Forming Level II - Slide Forming Operations |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|4529 |

|Reading Comprehension - English |

|E |

|Skill |

|0369 |

|Brainbench |

| |

| |

|0723 |

|Machining Level I - Manual Drill Press Operations |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0721 |

|Machining Level I - Manual Milling |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0724 |

|Machining Level I - Manual Surface Grinding |

|A |

|Common |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3821 |

|Machining Level II - Manual Milling |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|3837 |

|Slide Forming Level III - Slide Forming Set Up and Operations |

|B |

|Advanced |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

| |

| |

|0369 |

|Brainbench |

| |

| |

|0137 |

|National Institute for Metalworking Skills |

| |

| |

|0466 |

|Society of Tribologists and Lubrication Engineers |

| |

| |

| |

|51404100 |

|Machinists |

| |

| |

................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download