kRxZy commented 2025年10月20日 15:18:42 +02:00

Internal API Endpoints Documentation

Creating Projects

Endpoint:

POST /internalapi/create/projects?title={projectTitle || 'Untitled Project'}

Auth: Requires cookies

Behavior:

• A default .sb3 file is uploaded to the server (static/default-project/Project.apz)

• A project.json file is stored in:

  prisma/internal/projects/{ID}.json
  

• Assets are stored in:

  prisma/internal/assets/
  

---

Updating Projects

Endpoint:

POST /internalapi/projects/update?pID={projectid}&title={projectTitle}

Auth: Requires cookies

Behavior:

• Updated assets stored in:

  prisma/internal/assets/
  

• Updated project data stored as:

  prisma/internal/projects/{id}.json
  

---

User Management

Create Account (Signup)

Endpoint:

POST /internalapi/join

Storage:
User data saved in:

prisma/internal/db/ampmod.sqlite

Login

Endpoint:

POST /internalapi/login

Data Source:
Fetched from:

prisma/internal/db/ampmod.sqlite

Session

Endpoint:

GET /internalapi/session

Auth: Requires cookies

Returns:

• userData
• meta

---

Project Data

Project Meta

Endpoint:

GET /internalapi/projects/{id}

Returns:
Project metadata from:

prisma/internal/db/ampmod.sqlite

Project JSON

Endpoint:

GET /internalapi/{id}

Returns:
The full project.json file from:

prisma/internal/projects/{id}.json

Project Assets (Coming Soon)

Endpoint:

GET /internalapi/assets/:md5

Returns:
Assets as attachments from:

prisma/internal/assets/{md5hash}.{md5ext}

---

Project Creation Endpoint (Frontend)

Endpoint:

/projects/create

---

Signup Endpoint (Frontend)

Endpoint:

/join

---

How to Run

Setup Database

npm run db:push

Setup Project

npm run build && npm run preview

This uses the Vercel adapter, so it cannot be self-hosted. Made for Vercel only.

enhanced with ai

# Internal API Endpoints Documentation ## Creating Projects **Endpoint:** ``` POST /internalapi/create/projects?title={projectTitle || 'Untitled Project'} ``` **Auth:** Requires cookies **Behavior:** * A default `.sb3` file is uploaded to the server (`static/default-project/Project.apz`) * A `project.json` file is stored in: ``` prisma/internal/projects/{ID}.json ``` * Assets are stored in: ``` prisma/internal/assets/ ``` --- ## Updating Projects **Endpoint:** ``` POST /internalapi/projects/update?pID={projectid}&title={projectTitle} ``` **Auth:** Requires cookies **Behavior:** * Updated assets stored in: ``` prisma/internal/assets/ ``` * Updated project data stored as: ``` prisma/internal/projects/{id}.json ``` --- ## User Management ### Create Account (Signup) **Endpoint:** ``` POST /internalapi/join ``` **Storage:** User data saved in: ``` prisma/internal/db/ampmod.sqlite ``` ### Login **Endpoint:** ``` POST /internalapi/login ``` **Data Source:** Fetched from: ``` prisma/internal/db/ampmod.sqlite ``` ### Session **Endpoint:** ``` GET /internalapi/session ``` **Auth:** Requires cookies **Returns:** * `userData` * `meta` --- ## Project Data ### Project Meta **Endpoint:** ``` GET /internalapi/projects/{id} ``` **Returns:** Project metadata from: ``` prisma/internal/db/ampmod.sqlite ``` ### Project JSON **Endpoint:** ``` GET /internalapi/{id} ``` **Returns:** The full `project.json` file from: ``` prisma/internal/projects/{id}.json ``` ### Project Assets (Coming Soon) **Endpoint:** ``` GET /internalapi/assets/:md5 ``` **Returns:** Assets as attachments from: ``` prisma/internal/assets/{md5hash}.{md5ext} ``` --- ## Project Creation Endpoint (Frontend) **Endpoint:** ``` /projects/create ``` --- ## Signup Endpoint (Frontend) **Endpoint:** ``` /join ``` --- ## How to Run ### Setup Database ``` npm run db:push ``` ### Setup Project ``` npm run build && npm run preview ``` > This uses the Vercel adapter, so it cannot be self-hosted. Made for Vercel only. # enhanced with ai

ampelc commented 2025年11月09日 22:28:33 +01:00

@kRxZy_kRxZy wrote in #7 (comment):

This uses the Vercel adapter, so it cannot be self-hosted. Made for Vercel only.

we never intended for aw3 to run on vercel, it was intended to be self-hosted
i'm more of a self-hosted guy than a let-my-app-onto-some-weird-host-that-schools-may-block guy
the recent rewrite of aw3 was caused by a bunch of weird mess that made everything unmaintainable, including the vercel situation

@kRxZy_kRxZy wrote in https://codeberg.org/ampmod/aw3/issues/7#issue-2538488: > This uses the Vercel adapter, so it cannot be self-hosted. Made for Vercel only. we never intended for aw3 to run on vercel, it was intended to be self-hosted i'm more of a self-hosted guy than a let-my-app-onto-some-weird-host-that-schools-may-block guy the recent rewrite of aw3 was caused by a bunch of weird mess that made everything unmaintainable, including the vercel situation

ampelc commented 2025年11月09日 22:29:49 +01:00

aw3 now internalises the api into its routes, though we will expose some apis for other stuff to use

aw3 now internalises the api into its routes, though we will expose some apis for other stuff to use

ampelc commented 2025年11月14日 17:48:15 +01:00

outdated

outdated