You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/guides/create-an-app.md
+24-36Lines changed: 24 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,67 +11,55 @@ To start accessing parts of the API that require authentication you will need an
11
11
12
12
## Creating an App
13
13
14
-
Start by visiting [account.app.net/settings/](https://account.app.net/settings/).
14
+
1.Start by visiting [account.app.net/settings/](https://account.app.net/settings/). Click on "[Your Apps](https://account.app.net/developer/apps/)" in the bottom left hand corner to go to Your Apps Dashboard.
This is what you will see if you haven't created any apps. To start the process of registering your app click on [Create one here](https://account.app.net/developer/app/create/).
22
+
3. Fill in information about your app.
23
23
24
-
Next, you will see the App Create page.
24
+
All of the form details are required but you can always edit them later if you'd like to change anything. Give your app a unique name and provide a URL for users to find out more information. If it doesn't make sense for you to enter a website feel free to use your Alpha profile URL: `https://app.net/{YOUR USERNAME}`. This will let others know who is responsible for this app.
25
25
26
-
26
+
The *Redirect URL* is used when your app [authenticates new users](/reference/authentication/). If you're not sure what to fill in, you can use `http://localhost:8000` (which we've already filled in for you).
27
27
28
-
You will be able to change all of this later, but start by giving your app a name that is unique to you, or your organization.
28
+
Once all the fields are filled in, click "Create."
29
29
30
-
Enter a website that is most closely related to this app. If it doesn't make sense for you to enter a website feel free to enter in your Alpha profile URL. (https://app.net/<YOURUSERNAME>). This will let others know who is responsible for this app.
30
+
31
31
32
-
The **Redirect URL** is prefilled with http://localhost:8000 as a convenience for local development. The Redirect URL will be used when you [authenticate your app](/reference/authentication/) later.
32
+
4. Your app is now created. From here you can copy your *Client ID* and *Client Secret* into your code and use them. You can also add additional *Redirect URLs*for other development or production environments. To generate an access token, follow the instructions in the next section of this page.
33
33
34
-
When you are satisfied with the information you have entered click create.
35
-
36
-
You will see something like this once you have created your app.
37
-
38
-
39
-
40
-
As you can see the **client secret** is blurred, but this is roughly what your app will look like once it has been created.
41
-
42
-
From here you could add additional callback URL's for different environments. As well as update your apps information at any time.
43
-
44
-
You can also generate your self an access token.
34
+
45
35
46
36
## Generating an Access Token
47
37
48
38
There are a few ways to get an access token, but the easiest way to get an access token for personal use or experimentation is to generate one from your app detail page.
49
39
50
-
To see a list of your current apps visit [account.app.net/developer/apps/](https://account.app.net/developer/apps/).
1. Visit [account.app.net/developer/apps/](https://account.app.net/developer/apps/). Find the app you would like to generate an access token for and click on the name.
53
41
54
-
Find the app you would like to generate an access token for and click on the name. You should now see your app detail page.
44
+
2. Click "Generate a user token for yourself"
57
45
58
-
From this screen, if you look at the second block you will see a link: 'Generate a user token for yourself'. Click on that link, and you will see a page like this.
46
+
This is the scope authorization screen. If you have previously generated a token, some of these boxes may already be checked.
50
+
To find out more about scopes your can [read the scope docs](/reference/authentication/#scopes). If you have previously generated a token, some of these boxes may already be checked.
63
51
64
-
To find out more about scopes your can [read the scope docs](/reference/authentication/#scopes).
52
+
Once you have determined which scopes you will need select them in the form and then click "Generate."
65
53
66
-
Once you have determined which scopes you will need select them in the form and then click generate.
56
+
4. You now have a user access token for your app. You can copy that into your code and use it with a [client library](/docs/libraries/) or directly from curl.
69
57
70
-
Now you should see an access token in a textbox, then you can copy and use in a client library, or even from curl.
58
+
<divclass="alert alert-error alert-block">
59
+
<b>Remember</b>: An access token is just like a password. It will allow applications to interact with the API on your behalf. So, keep it secret.
60
+
</div>
71
61
72
-
<divclass="alert alert-error alert-block">
73
-
<b>Remember</b>: An access token is just like a password. It will allow applications to interact with the API on your behalf. So, keep it secret.
74
-
</div>
62
+
0 commit comments