### Application Registration

Source: https://developer.arthuronline.co.uk/?version=latest/index_version=latest

Register your third-party application to obtain a client ID and client secret for API authentication. This process involves providing your application's name, description, website URL, and a secure callback URL.

```APIDOC
## Application Registration

### Description
Register your third-party application to obtain a client ID and client secret for API authentication. This process involves providing your application's name, description, website URL, and a secure callback URL.

### Method
Not Applicable (Web UI process)

### Endpoint
Not Applicable (Web UI process)

### Parameters
#### Form Fields
- **Name** (string) - Required - The display name of your application.
- **Description** (string) - Optional - A brief description of your application's functionality.
- **Website** (URL) - Optional - The URL of your application's website.
- **Callback URL** (URL) - Required - The secure (HTTPS) URL to redirect users after successful authentication. Must match the registered URL.

### Request Example
Not Applicable (Web UI process)

### Response
Upon successful registration, the system generates a unique `client ID` and `client secret` for your application.

#### Success Response
- **client_id** (string) - Unique identifier for your application.
- **client_secret** (string) - Confidential secret for your application.

#### Response Example
Not Applicable (Generated by the system)
```

--------------------------------

### Request User Authorization

Source: https://developer.arthuronline.co.uk/?version=latest/index_version=latest

Initiate the OAuth 2.0 Authorization Code flow by requesting user authorization. This involves directing the user to Arthur's authorization URL with your application's client ID and redirect URI.

```APIDOC
## Request User Authorisation

### Description
Initiate the OAuth 2.0 Authorization Code flow by requesting user authorization. This involves directing the user to Arthur's authorization URL with your application's client ID and redirect URI. The authorization code received is temporary and expires in 15 minutes.

### Method
GET

### Endpoint
`https://auth.arthuronline.co.uk/oauth/authorize`

### Parameters
#### Query Parameters
- **client_id** (string) - Required - The unique identifier for your third-party application, obtained after registration.
- **redirect_uri** (URL) - Required - The callback URL registered during application registration. This URL must use secure HTTP (HTTPS) and match the registered value.

### Request Example
```curl
curl --location -g 'https://auth.arthuronline.co.uk/oauth/authorize?client_id={{your_client_id}}&redirect_uri={{your_redirect_uri}}'
```

### Response

#### Success Response (302 Found)
Upon user authorization, the user is redirected to the specified `redirect_uri` with an authorization code appended as a query parameter.

- **code** (string) - A temporary authorization code (expires in 15 minutes).

#### Response Example
No response body. The response is a redirect to the `redirect_uri` with the `code` parameter.
```

--------------------------------

### Request User Authorization via cURL

Source: https://developer.arthuronline.co.uk/?version=latest/index_version=latest

This snippet demonstrates how to request user authorization for your application using cURL. It requires your application's client ID and the registered redirect URI. The authorization code obtained from this request is temporary and expires within 15 minutes.

```cURL
curl --location -g 'https://auth.arthuronline.co.uk/oauth/authorize?client_id={{your_client_id}}&redirect_uri={{your_redirect_uri}}'
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.