API.java

package io.evercam;

import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;
import org.json.JSONException;
import org.json.JSONObject;

import java.io.IOException;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;

public abstract class API {
    public static String VERSION = "v1";
    public static String MEDIA_VERSION = "v1";
    public static final String PRODUCTION_URL = "https://media.evercam.io/" + VERSION + "/";
    public static final String MEDIA_URL = "https://media.evercam.io/" + MEDIA_VERSION + "/";
    public static String URL = PRODUCTION_URL;
    public static final String AWS_ASSETS_URL = "http://evercam-public-assets.s3.amazonaws.com/";

    private static String[] userKeyPair = {null, null};

    /**
     * Set developer app key pair.
     * Developer key pair will be send along with API requests that require user authentication.
     *
     * @param userApiKey Evercam user API key
     * @param userApiID  Evercam user API id
     */
    public static void setUserKeyPair(String userApiKey, String userApiID) {
        userKeyPair[0] = userApiKey;
        userKeyPair[1] = userApiID;
    }

    /**
     * Return the user key pair as an array with two values.
     * The values will be null if user key pair has not being set.
     */
    public static String[] getUserKeyPair() {
        return userKeyPair;
    }

    /**
     * Whether or not the user key pair has been added.
     *
     * @return true if the user key pair has been added, otherwise return false.
     */
    public static boolean hasUserKeyPair() {
        return ((userKeyPair[0] != null) && (userKeyPair[1] != null));
    }

    /**
     * Return the hash map of user key and id.
     */
    public static Map<String, Object> userKeyPairMap() {
        Map<String, Object> map = new HashMap<String, Object>();
        map.put("api_key", getUserKeyPair()[0]);
        map.put("api_id", getUserKeyPair()[1]);
        return map;
    }

    /**
     * Fetch API credentials for an authenticated user.
     *
     * @param username Username or Email address for the user to fetch credentials for
     * @param password Password for the user to fetch credentials for.
     * @return the user API credentials (key and id)
     * @throws EvercamException if developer key and id is not added
     */
    public static ApiKeyPair requestUserKeyPairFromEvercam(String username, String password) throws EvercamException {
        ApiKeyPair userKeyPair = null;

        try {
            DefaultHttpClient client = new DefaultHttpClient();
            String encodedPassword = URLEncoder.encode(password, "UTF-8");
            HttpGet get = new HttpGet(URL + "/users/" + username + "/credentials?password=" + encodedPassword);
            get.setHeader("Accept", "application/json");
            org.apache.http.HttpResponse response = client.execute(get);
            String result = EntityUtils.toString(response.getEntity());
            int statusCode = response.getStatusLine().getStatusCode();

            if (statusCode == EvercamObject.CODE_OK) {
                JSONObject keyPairJsonObject = new JSONObject(result);
                userKeyPair = new ApiKeyPair(keyPairJsonObject);
            } else {
                throw new EvercamException(new JSONObject(result).getString("message"));
            }
        } catch (ClientProtocolException e) {
            throw new EvercamException(e);
        } catch (IOException e) {
            throw new EvercamException(e);
        } catch (JSONException e) {
            throw new EvercamException(e);
        }
        return userKeyPair;
    }

    public static void resetUrl() {
        URL = PRODUCTION_URL;
    }

    /**
     * Returns snapshot URL for the specified camera
     *
     * @throws EvercamException if user key pair not specified
     */
    public static String generateSnapshotUrlForCamera(String cameraId) throws EvercamException {
        if (hasUserKeyPair()) {
            return Camera.URL + '/' + cameraId + "/live/snapshot?api_id=" + getUserKeyPair()[1] + "&api_key=" +
                    getUserKeyPair()[0];
        } else {
            throw new EvercamException(EvercamException.MSG_USER_API_KEY_REQUIRED);
        }
    }
}