Rust GraphQL API

A complete GraphQL API built with Rust, Rocket, Juniper, and SeaORM.

Project Structure

rust-api/
├── Cargo.toml
├── database.sqlite
├── src/
│ ├── main.rs
│ ├── entity/
│ │ ├── mod.rs
│ │ └── hobbit.rs
│ └── graphql/
│ ├── mod.rs
│ └── schema/
│ ├── mod.rs
│ └── hobbit/
│ ├── mod.rs
│ ├── types.rs
│ └── operations.rs

Setup Instructions

1. Install Dependencies (if not already installed)

Make sure you have Rust 1.70+ installed. Install SeaORM CLI:

cargo install sea-orm-cli

2. Initialize Migrations (Optional)

If you want to use SeaORM migrations:

sea-orm-cli migrate init
sea-orm-cli migrate generate "create_hobbit_table" -d ./migration

Then replace the migration file with the content from the tutorial, or manually create the table:

CREATETABLEIF NOT EXISTS hobbit (
id INTEGERPRIMARY KEY AUTOINCREMENT,
name TEXTNOT NULL,
surname TEXTNOT NULL
);

3. Create Database Table

You can either:

Option A: Manual SQL

sqlite3 database.sqlite

Then run:

CREATETABLEIF NOT EXISTS hobbit (
id INTEGERPRIMARY KEY AUTOINCREMENT,
name TEXTNOT NULL,
surname TEXTNOT NULL
);

Exit with .quit

Option B: Using SeaORM Migration After setting up the migration file, run:

sea-orm-cli migrate up

4. Run the Server

cargo run

The server will start on http://localhost:8000

Available Endpoints

• http://localhost:8000/ - Homepage with links
• http://localhost:8000/graphiql - GraphiQL interface for testing
• http://localhost:8000/playground - GraphQL Playground
• http://localhost:8000/graphql - GraphQL endpoint (POST)

Example Queries

Query all hobbits

query {
hobbits {
idnamesurname
}
}

Create a hobbit

mutation {
createHobbit(input: {
name: "Frodo"surname: "Baggins"
}) {
idnamesurname
}
}

Update a hobbit

mutation {
updateHobbit(
id: 1input: {
name: "Frodo"surname: "Took"
}
) {
idnamesurname
}
}

Delete a hobbit

mutation {
deleteHobbit(id: 1)
}

Tech Stack

• Rocket - Web framework
• Juniper - GraphQL implementation
• SeaORM - Async ORM
• SQLite - Database
• Tokio - Async runtime