Skip to content

Commit

Permalink
Merge pull request #3 from ITsPorky/development
Browse files Browse the repository at this point in the history
Updated README.md to include a Getting Started section
  • Loading branch information
ITsPorky authored Feb 5, 2024
2 parents bf99b5a + d1e4a16 commit 9c6c6a0
Showing 1 changed file with 51 additions and 7 deletions.
58 changes: 51 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,57 @@ To generate characters, manipulate the seed value in the URL, determining the ch

**Note: Version 2 is currently in progress.**

## Understanding Response Types
## Getting Started

Follow these instructions to get a copy of the project up and running on your local machine.

### Prerequisites

- Node.js installed on your machine

### Installing

1. Clone the repository:

```bash
git clone https://github.com/ITsPorky/Character-Generation-API.git
```

2. Navigate to the project directory:

```bash
cd Character-Generation-API
```

3. Install dependencies:

```bash
npm install
```
OR
```bash
npm i
```

### Running the App

1. Start the development server:

```bash
npm start
```

2. Open your browser and visit [http://localhost:3000](http://localhost:3000) to view the app.

## Usage

### Understanding Response Types

This API provides various response types for creating diverse characters. It includes different versions for generating distinct styles of character design:

### Version 1
#### Version 1

#### Character Card (format: `.png`)
##### Character Card (format: `.png`)

To obtain a Character Card, use the following URL format: `/v1/card/seed/{seed_value}/1x.png`.

Expand All @@ -39,7 +83,7 @@ To obtain a Character Card, use the following URL format: `/v1/card/seed/{seed_v
**Example Response**:
![Seeded Characters Card](https://character-gen-api.onrender.com/seed/0/1x.png)
#### Character Sprite (format: `.png`)
##### Character Sprite (format: `.png`)
To retrieve a Character Sprite, use the URL format: `/v1/sprite/seed/{seed_value}/1x.png`.
Expand All @@ -52,7 +96,7 @@ To retrieve a Character Sprite, use the URL format: `/v1/sprite/seed/{seed_value
**Example Response**:
![Seeded Character Sprite](https://character-gen-api.onrender.com/sprite/seed/0/10x.png)
#### Weapon Sprite (format: `.png`)
##### Weapon Sprite (format: `.png`)
To obtain a Weapon Sprite, use the URL format: `/v1/weapon/seed/{seed_value}/1x.png`.
Expand All @@ -65,7 +109,7 @@ To obtain a Weapon Sprite, use the URL format: `/v1/weapon/seed/{seed_value}/1x.
**Example Response**:
![Seeded Weapon Sprite](https://character-gen-api.onrender.com/weapon/seed/0/10x.png)
#### Character Metadata (format: `JSON`)
##### Character Metadata (format: `JSON`)
To retrieve Character Metadata, use the URL format: `/v1/seed/{seed_value}/metadata`.
Expand All @@ -76,7 +120,7 @@ To retrieve Character Metadata, use the URL format: `/v1/seed/{seed_value}/metad
This response includes all generated character information, such as character card URL, character sprite URL, weapon sprite URL, and additional data not displayed on the character card.
### Version 2
#### Version 2
Work in progress...
Expand Down

0 comments on commit 9c6c6a0

Please sign in to comment.