1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Register application to get Client Key and Client Secret</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="Flickcurl Flickr API Manual">
<link rel="up" href="flickcurl-auth.html" title="Authenticating Flickcurl for OAuth">
<link rel="prev" href="flickcurl-auth-build.html" title="Build Flickcurl library and flickcurl(1) utility">
<link rel="next" href="flickcurl-auth-authenticate.html" title="Getting Authentication Token from Client Key and Client Secret">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="flickcurl-auth-build.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="flickcurl-auth.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Flickcurl Flickr API Manual</th>
<td><a accesskey="n" href="flickcurl-auth-authenticate.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="flickcurl-auth-register"></a>Register application to get Client Key and Client Secret</h2></div></div></div>
<p>NOTE: In the pictures below, the Flickr web site is shown in
English and the screenshots are valid as of August 2012. Flickr
upgrade the web site now and then so these instructions may not match
the latest look. Hopefully you can figure it out!</p>
<p>
Start by navigating to the Flickr <span class="emphasis"><em>App Garden</em></span> at
<a class="ulink" href="http://www.flickr.com/services/" target="_top">http://www.flickr.com/services/</a>
and follow the link 'Create an App' taking you to
<a class="ulink" href="http://www.flickr.com/services/apps/create/" target="_top">http://www.flickr.com/services/apps/create/</a>
</p>
<div class="mediaobject" align="center">
<img src="appgarden-get-your-api-key.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Get your API Key</p></div>
</div>
<p>
Select the link 'Request an API Key' taking you to
<a class="ulink" href="http://www.flickr.com/services/apps/create/apply/" target="_top">http://www.flickr.com/services/apps/create/apply/</a>
</p>
<div class="mediaobject" align="center">
<img src="appgarden-commercial-picker.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Commercial / Non-Commercial</p></div>
</div>
<p>
Select either of the two buttons:
'Apply for a Non-Commercial Key' or 'Apply for a Commercial Key'
as appropriate.
</p>
<div class="mediaobject" align="center">
<img src="appgarden-tell-us-about-your-app.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Describe application</p></div>
</div>
<p>
Fill in the form fields and submit it via the 'Submit' button.
</p>
<div class="mediaobject" align="center">
<img src="appgarden-new-api-key-secret.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Key and Secret</p></div>
</div>
<p>Flickr will return a page containing both the
API <span class="emphasis"><em>Key</em></span> that looks something like:
</p>
<pre class="programlisting">
0123456789abcdef0123456789abcdef
</pre>
<p>and <span class="emphasis"><em>Secret</em></span> which looks something like:</p>
<pre class="programlisting">
fedcba9876543210
</pre>
<p>
These strings should be used for the values of the Client Key
(<code class="code">oauth_client_key</code>) and Client Secret
(<code class="code">oauth_client_secret</code>) keys in either
the <code class="filename">~/.flickcurl.conf</code> if used with the <span class="command"><strong>flickcurl(1)</strong></span> utility
or in code, with the
<a class="link" href="flickcurl-section-auth.html#flickcurl-set-oauth-client-key" title="flickcurl_set_oauth_client_key ()">flickcurl_set_oauth_client_key()</a>
and
<a class="link" href="flickcurl-section-auth.html#flickcurl-set-oauth-client-secret" title="flickcurl_set_oauth_client_secret ()">flickcurl_set_oauth_client_secret()</a>
functions.
</p>
<p>
You may need to change the key to be of type mobile since no callback
URL is usually appropriate for a command-line application or library.
This step is probably no longer needed since the callback is
specified in a later step.
</p>
<p>
Click the 'Edit auth flow for this app' link below the
<span class="emphasis"><em>Key</em></span> and <span class="emphasis"><em>Secret</em></span>
</p>
<div class="mediaobject" align="center">
<img src="appgarden-edit-auth-flow.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Edit authentication flow</p></div>
</div>
<p>Change the 'App Type' to 'Mobile Application'
then set the 'Mobile Permissions' to 'Read', 'Write' Or 'Delete' as
appropriate.
</p>
<div class="mediaobject" align="center">
<img src="appgarden-edit-auth-flow-mobile.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Edit authentication flow: mobile</p></div>
</div>
<p>
This sequence will make the new key 'Auth mode Mobile'
and an <span class="emphasis"><em>authentication URL</em></span> will be shown on the
same page something like
<code class="code">http://www.flickr.com/auth-11111111111111111</code>.
This URL should <span class="emphasis"><em>NOT</em></span> be used and is only for
the legacy Flickr authentication flow.
</p>
<p>Finish with the 'Save Changes' button to confirm and return
you to the application page.</p>
<div class="mediaobject" align="center">
<img src="appgarden-test-app-page.png" align="middle" width="432"><div class="caption"><p>Flickr App Garden - Application page</p></div>
</div>
<p>
If you ever need to alter or view the authentication, use the link
'Edit the authentication flow' on right-hand side of the application page.
</p>
<p>All your Flickr applications are linked from
<a class="ulink" href="http://www.flickr.com/services/apps/by/me" target="_top">http://www.flickr.com/services/apps/by/me</a>
</p>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.18</div>
</body>
</html>
|
