Привет, хабралюди!

Хочу поделиться с вами небольшим опытом использования Flickr API в Android приложениях и рассказать об авторизации пользователя Flickr. Которую в дальнейшем можно будет использовать например для вывода списка альбомов и изображений.

Регистрация приложения

Первым делом нам нужно получить API Key, приложения будем использовать не в коммерческих целях, для регистрации переходим по ссылке Create an App.

Нас просят ввести «Название», «Цель» и «Соглашения с правами», отправляем наши данные и в результати получаем API Key и API Secret. Они нужны нам в дальнейшем для формирования запроса к серверу.

После этого нам нужно редактировать некоторые данные, в этом же окне переходим на Edit auth flow for this app.

Описания и логотип нам не интересны, вводить можете по желанию. В поле Callback URL нам обязательно нужно задать адрес обратного вызова, который мы будем использовать для возвращения к нашему Activity. В моем случае я задаю appforflickr://callback. В болке <intent-filter> это буде выглядеть следующим образом:

...
<data android:scheme="appforflickr" android:host="callback"/>
...

App Type — выбираем Web Application и Сохраняем изменения.

Далее переходим непосредственно к построения самого приложения.

В манифесте приложения добавляем «android.permission.INTERNET» и блок <intent-filter> в результате получаем:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="test.testflickrapi" >

    <uses-permission android:name="android.permission.INTERNET"/>

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name=".ui.activities.MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.VIEW"/>

                <category android:name="android.intent.category.DEFAULT"/>
                <category android:name="android.intent.category.BROWSABLE"/>

                <data android:scheme="appforflickr" android:host="callback"/>
            </intent-filter>
        </activity>
    </application>

</manifest>

Создание ссылки для авторизации пользователя

Для авторизации пользователей в приложении мы будем запускать Activity с WebView. Но сначала сформируем адрес для входа. Шаблон выглядет следующим образом:

http://flickr.com/services/auth/?api_key=[api_key]&perms=[perms]&api_sig=[api_sig]

[api_key] — это наш ключ полученый при регистрации приложения. [perms] — уровень доступа к аккаунту, может принимать следующие значения:

read — разрешения на чтения личной информации
write — разрешения на добавления и редактирования фотографий и информации(включает в себя 'read')
delete — разрешения на удаления фотографий(включает в себя 'read' и 'write ')

[api_sig] — подпись, она включает в себя Secret полученый при регистрации приложения и список аргументов в алфавитном порядке, имя и значения.
В нашем случае API Key: 5744fadec815a7e8142d03901065c97b, API Secret: 8b2c12e80b67970b, права доступа write, подпись это строка из:

secret + 'api_key' + [api_key] + 'perms' + [perms]

, то есть мы имеем: 8b2c12e80b67970bapi_key5744fadec815a7e8142d03901065c97bpermswrite и теперь нужно зашифровать эту строку в MD5. Для этого используем следующий метод:

public static final String md5SumOfString(final String s) {
        try {
            MessageDigest digest = java.security.MessageDigest.getInstance("MD5");
            digest.update(s.getBytes());
            byte messageDigest[] = digest.digest();

            StringBuffer hexString = new StringBuffer();
            for (int i = 0; i < messageDigest.length; i++)
                hexString.append(Integer.toHexString(0xFF & messageDigest[i]));
            return hexString.toString();

        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        }
        return "";
    }

и получем значения [api_sig].

В итоге адрес для авторизация пользователя будет выглядеть следующим образом:

http://www.flickr.com/services/auth/?api_key=9a0554259914a86fb9e7eb014e4e5d52&perms=write&api_sig=b8d7c1ae026d5f86f1f44944f5257f3

В onCreate() добавляем

startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url)));

, где url — это вышеуказанный адрес. После запуска приложения мы открываем веб-страницу, чтобы указать логин и пароль. Если введеные данные будут верны нас по Callback URL автоматически перенаправит на наше приложеня. К url добавляеться параметр frob из значениям, то есть в нашем случае это выглядит так:

appforflickr://callback?frob=72157650137623777-b09eae52121bf8ad-130818926

Frob нужен для получения Access token.
Добавим условия в onCreate(), чтобы получить frob:

Uri uri = getIntent().getData();
if (uri != null) {
    String frob = uri.getQueryParameter("frob");
} else 
	startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url)));

После того обработки вызываем метод flickr.auth.getToken из API для получения token и nsid, которые понадобятся для дальнейших запросов, а так же username и fullname пользователя.

Для отправки запросов создадим class HttpRequest:

public class HttpRequest extends AsyncTask<String, String, String> {

    public static final String TAG = HttpRequest.class.getSimpleName();

    @Override
    protected void onPreExecute() {
        Log.d(TAG, "START");
    }

    @Override
    protected String doInBackground(String... params) {
        String result = "";
        try {
            String uri = params[0];
            HttpGet httpGet = new HttpGet(uri);
            HttpResponse response = HttpClientHelper.getHttpClient().execute(httpGet);
            HttpEntity entity = response.getEntity();
            if (entity != null) {
                InputStream inStream = entity.getContent();
                result = InputStreamConverter.convertStreamToString(inStream);
                inStream.close();
            }
            return result;
        } catch (IllegalStateException e) {
            return result;
        } catch (ClientProtocolException e) {
            return result;
        } catch (IOException e) {
            return result;
        }
    }

    @Override
    protected void onPostExecute(String result) {
        Log.d(TAG, "STOP");
    }
}

Class HttpClientHelper для получения HttpClient:

public class HttpClientHelper {

    private static HttpClient httpClient = null;
    private static final int REGISTRATION_TIMEOUT = 30 * 1000;
    private static final int WAIT_TIMEOUT = 30 * 1000;

    private HttpClientHelper() {}

    public static synchronized HttpClient getHttpClient() {
        if (httpClient == null) {
            HttpParams params = new BasicHttpParams();
            HttpProtocolParams.setVersion(params, HttpVersion.HTTP_1_1);
            HttpProtocolParams.setContentCharset(params, HTTP.DEFAULT_CONTENT_CHARSET);
            HttpProtocolParams.setUseExpectContinue(params, true);
            ConnManagerParams.setTimeout(params, WAIT_TIMEOUT);
            HttpConnectionParams.setConnectionTimeout(params, REGISTRATION_TIMEOUT);
            HttpConnectionParams.setSoTimeout(params, WAIT_TIMEOUT);
            SchemeRegistry schemeReg = new SchemeRegistry();
            schemeReg.register(new Scheme("http", PlainSocketFactory.getSocketFactory(), 80));
            schemeReg.register(new Scheme("https", SSLSocketFactory.getSocketFactory(), 443));
            ClientConnectionManager connectionMgr = new ThreadSafeClientConnManager(params, schemeReg);
            httpClient = new DefaultHttpClient(connectionMgr, params);
        }
        return httpClient;
    }
}

Class InputStreamConverter для конвертации InputStream в String:

public class InputStreamConverter {

    private InputStreamConverter() {}

    public static String convertStreamToString(InputStream inputStream) {
        BufferedReader reader = new BufferedReader(new InputStreamReader( inputStream));
        StringBuilder builder = new StringBuilder();
        String line = null;
        try {
            while ((line = reader.readLine()) != null) {
                builder.append(line + "\n");
            }
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                inputStream.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        return builder.toString();
    }
}

Адрес для получения token:

https://api.flickr.com/services/rest/?method=flickr.auth.getToken&api_key=9a0554259914a86fb9e7eb014e4e5d52&frob=72157650137623777-b09eae52121bf8ad-130818926&format=json&nojsoncallback=1&perms=write&api_sig=8fd09b55f670ec9a4ba07c076e520ae8

, чтобы ответ пришел в виде json мы добавили пераметры из значениями format=json и nojsoncallback=1

Вносим еще раз изминения в onCreate() для отправки запроса:

Uri uri = getIntent().getData();
if (uri != null) {
    String frob = uri.getQueryParameter("frob");
    String url = "..."; // Наш сформированый адрес для получения token
	
	String response = "";
	HttpRequest httpRequest = new HttpRequest(this);
	httpRequest.execute(url);
	try {
		response = httpRequest.get();
	} catch (InterruptedException | ExecutionException e) {
		e.printStackTrace();
	}
	
} else 
	startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url)));

Далее полученый ответ:

{"auth":{"token":{"_content":"12134650097774510-014feda8303a4a64"},"perms":{"_content":"write"},"user":{"nsid":"230211065@N05","username":"user","fullname":"User Alex"}},"stat":"ok"}

можна розпарсить получить желанный token и nsid при помощи таких библиотек как gson или jackson это уже на любителя.

Надеюсь моя статья будет кому-то полезна.

PS. Это мой первый пост на Хабре, так что извините за немногословность и не судите строго.

Flickr API в Android App. Авторизация