Submissions.java

/**
 * Copyright 2014 Upwork
 *
 * Licensed under the Upwork's API Terms of Use;
 * you may not use this file except in compliance with the Terms.
 * You may obtain a copy of the Terms at
 * 
 *    http://developers.upwork.com/API-Terms-of-Use
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.Upwork.api.Routers.Hr;

import java.util.HashMap;

import com.Upwork.ClassPreamble;
import com.Upwork.api.OAuthClient;

import org.json.JSONException;
import org.json.JSONObject;

@ClassPreamble (
	author = "Maksym Novozhylov <mnovozhilov@upwork.com>",
	date = "11/17/2014",
	currentRevision = 1,
	lastModified = "11/17/2014",
	lastModifiedBy = "Maksym Novozhylov",
	reviewers = {"Yiota Tsakiri"}
)
public final class Submissions {
	
	final static String ENTRY_POINT = "api";
	
	private OAuthClient oClient = null;

	public Submissions(OAuthClient client) {
		oClient = client;
		oClient.setEntryPoint(ENTRY_POINT);
	}
	
	/**
     * Freelancer submits work for the client to approve
     *
     * @param   params Parameters
     * @throws	JSONException If error occurred
	 * @return	{@link JSONObject}
     */
    public JSONObject requestApproval(HashMap<String, String> params) throws JSONException {
        return oClient.post("/hr/v3/fp/submissions", params);
    }
    
    /**
     * Approve an existing Submission
     *
     * @param	submissionId Submission ID
     * @param   params Parameters
     * @throws	JSONException If error occurred
	 * @return	{@link JSONObject}
     */
    public JSONObject approve(String submissionId, HashMap<String, String> params) throws JSONException {
        return oClient.put("/hr/v3/fp/submissions/" + submissionId + "/approve", params);
    }
    
    /**
     * Reject an existing Submission
     *
     * @param	submissionId Submission ID
     * @param   params Parameters
     * @throws	JSONException If error occurred
	 * @return	{@link JSONObject}
     */
    public JSONObject reject(String submissionId, HashMap<String, String> params) throws JSONException {
        return oClient.put("/hr/v3/fp/submissions/" + submissionId + "/reject", params);
    }

}