Creating an Account

An API documentation example website

You must create an account before you can access the APIs.

Process Overview

These are the steps you’ll use to set up an account for the Groovy Guitars website:

  1. Generate a token. See Authentication and Authorization.
  2. Construct an account request. Build an account request by specifying your username, email address, authentication token from the previous step, and other information to create your unique account.
  3. Post an account request. Use Postman to post the account request to the Arizona Groovy Guitars website. The system processes your request and creates your account. You’ll receive an email notification after the system creates the account.
  4. Create a password to access the site. Use the website “Lost Password” feature to generate a password.
  5. Log in to your account.

These steps give you general access to the site. The site administrator can give you additional website permissions.

Constructing Account Requests

To request an account to the Groovy Guitars website, you must construct and post a request like the one shown in the following example:

http://groovyguitars.com/user/register/?username=mbrady&email=
marcia.brady@gmail.com&nonce=77aebaa1c0&display_name=Marcia&insecure=cool

This table highlights the parameters shown in the example:

Parameter Value Example
username Your username username=mbrady
email Your email address email=marcia.brady@gmail.com
nonce Token value you generated in the previous section nonce=77aebaa1c0
display_name Your display name display_name=Marcia
insecure Used if the site does use SSL. insecure=cool

To construct your request, you may want to paste the example above into a text editor and replace the parameter values as needed. Do not enter any spaces between the equal signs and your parameter values.

You’ll use your unique request URL in the next section.

Note: You’ll notice at the end of the request, there is a parameter insecure=cool. This denotes that the request has no security and that you’re aware and okay with that.

Posting Account Requests

To post the account request to the Groovy Guitars website, you’ll use Postman. This example shows the My Workspace in Postman.

To post the request, change the method from GET to POST, by selecting POST from the drop-down list. Then enter the URL you created in the last section into the Enter request URL field, and click the Send button.

When the post is successful, Postman displays a message like this one:

{

“status”: “ok”,

“cookie”: “mbrady|1537683059|ULd4uStEvlE4G6KeWDlKUK0cLUHwFHO3LowHA4aUpt8|d4c8d5d2ce5850d4acc5efae6e9cad3fb725aef756aaf1a440f3456407aded5e”,

“user_id”: 14

}

After you make the post request, the Groovy Guitars website processes the request and creates your account. You’ll receive an email notification when the system has created your account.

To post an account request:

  1. Open Postman.
  2. Open or create a Workspace.
  3. From the method drop-down list, select POST.
  4. In the Enter request URL field, enter the URL you created in the previous section. For example:

http://groovyguitars.com/user/register/?username=mbrady&email=marcia.brady@gmail.com&nonce=77aebaa1c0&display_name=Marcia&insecure=cool

If you are cutting and pasting from a text editor, be sure to remove any extra spaces or line returns.

  1. Click the Send button.

Postman displays a success response at the bottom of the page. If you get an error, check your request URL to make sure there are no extra spaces, and try again.

Creating Passwords

After your account is created, you’ll need to create a password before you can log in. For this step, use the WordPress “Lost Password” feature.

To create a password:

  1. Go to groovyguitars.com.
  2. Click Lost your password? at the bottom of the page.
  3. Enter your email address and click the Get New Password button.

The system sends a password reset link to your email address. It may take a few minutes to receive the notification. Follow the instructions for resetting your password.

Logging in to Your Account

To log in to your Groovy Guitars account:

  1. Go to groovyguitars.com.
  2. In the upper-right corner of the page, click Log In.
  3. In the Username field, enter the username you defined in your account request URL.
  4. In the Password field, enter the password you created using the Lost Password feature.
  5. Click the Log In button.
  6. In the upper-left corner of the page, click Groovy Guitars API.