fedi-image-bot
/
bot-api
2
3
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity
172 Commits 2 Branches 3 Tags 963 KiB
TypeScript 98%
Dockerfile 2%
Go to file
Alie fcf36c971e
Unit Tests with docker compose / unit-test (push) Successful in 25s Details
Build image / build (push) Successful in 46s Details
Merge branch 'develop' 		2024-04-21 13:28:37 +02:00
.gitea/workflows fix issues on test pipeline 2024-04-17 19:31:21 +02:00
src add cors to API 2024-04-21 13:27:58 +02:00
tests v1.0.0 (#28) 2024-01-14 19:49:34 +00:00
.dockerignore Adding docker compose to test api with mongodb 2023-12-25 07:47:16 +01:00
.gitignore changed to docker compose build 2024-04-20 12:45:15 +02:00
Dockerfile changed to docker compose build 2024-04-20 12:45:15 +02:00
Dockerfile.dev changed to docker compose build 2024-04-20 12:45:15 +02:00
README.md v1.0.0 (#28) 2024-01-14 19:49:34 +00:00
bun.lockb add cors to API 2024-04-21 13:27:58 +02:00
bunfig.toml v1.0.0 (#28) 2024-01-14 19:49:34 +00:00
compose.yaml changed to docker compose build 2024-04-20 12:45:15 +02:00
package.json add cors to API 2024-04-21 13:27:58 +02:00
tsconfig.json first commit 2023-12-08 14:05:20 +01:00
yarn.lock add cors to API 2024-04-21 13:27:58 +02:00

README.md

bot-api

Introduction

The function of the API is basically to access the images' metadata stored in the database.

Usage

The API exposes some endpoints to interact with the database.

GET /images

Allows to get a list of image documents.

Query params

  • limit: an optional parameter, which accepts a non-negative integer that dictates the number of documents that the list will have. If its value is equal to 0, or if this parameter is missing, the endpoint will return all the image documents in the database.
  • status: an optional parameter, which accepts the values consumed, available and unavailable. It filters the documents that have only the status attribute equal to that indicated in the parameter's value. If the parameter is missing, no filter will be applied to the document.

Example

  • GET /images?limit=5&status=available will return 5 documents that have the available value in their status attribute.

GET /images/<id>

Allows to get an image document.

Params

  • id: the id of the document to be modified.

Example

GET /images/61f7e48f0c651345677b7775 will get the document referenced by the id param.

PUT /images/<id>

Modifies an existing image document. The request must provide a JSON-formatted body, with one or more valid document attributes. The existing document attributes will be replaced with the provided new ones.

Params

  • id: the id of the document to be modified.

Example

  • PUT /images/61f7e48f0c651345677b7775 with body { "status": "consumed" } will modify the document referenced by the id param, changing their status value to consumed.

POST /images

Allows to insert a new image document.

Example

POST /images with body { "url": "https://my-images.com/foo.jpg", "status": "available", "tags": ["foo", "bar"] } will insert the image passed on the request body into the database.

POST /login

Generates an access token to use in future requests to authenticated endpoints if a valid App and Secret are provided.

Example

POST /login with body { "app": "example", "secret": "badsecret" } will return { "token": "x.y.z" } "x.y.z" being a JWT token to use on further requests if the App and Secret are valid.

Installation

To install dependencies:

bun install

To run:

bun run dev

For testing, remember:

bun run test

This project was created using bun init in bun v1.0.13. Bun is a fast all-in-one JavaScript runtime.