Skip to content

Commit 4c5c89e

Browse files
authored
Create README.md
1 parent 603bc71 commit 4c5c89e

File tree

1 file changed

+54
-0
lines changed

1 file changed

+54
-0
lines changed

README.md

+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# API pour Call Notifier
2+
3+
Cette API permet de faire une liaison entre le bot et le CLI lors de l'association d'une Freebox. Il est nécessaire d'héberger cette API si vous souhaiter hébergez le robot Telegram.
4+
5+
> Contrairement au CLI qui s'exécute sur l'ordinateur de l'utilisateur, l'API n'a pas besoin d'être connecté à une Freebox.
6+
7+
> Vous pouvez parfaitement utiliser cette API sur [Vercel](https://vercel.com/new), vous n'aurez qu'à fork ce repo et le configurer depuis votre panel.
8+
9+
## Utilisation d'une API personnalisée avec le CLI
10+
11+
```bash
12+
npm i -g freebox-notifier-cli
13+
fbx-associate https://url-de-votre-api.com
14+
```
15+
16+
## Installation
17+
18+
### Prérequis
19+
20+
- [Node.js](https://nodejs.org/fr/) (version 18 ou supérieure)
21+
- Un compte [Supabase](https://supabase.com/dashboard/sign-in) (gratuit)
22+
23+
### Configurer la base de données
24+
25+
> Cette base de donnée est commune pour le bot Telegram et l'API. Si vous avez déjà créer un projet Supabase, vous pouvez passer cette étape.
26+
27+
> Les instructions sont [disponibles ici](https://github.com/el2zay/wikis/wiki/H%C3%A9berger-soi%E2%80%90m%C3%AAme#configurer-la-base-de-donn%C3%A9es).
28+
29+
### Installation
30+
31+
1. Cloner le repository
32+
```sh
33+
git clone https://github.com/Freebox-Tools/api-notifier.git
34+
```
35+
36+
2. Installer les dépendances
37+
```sh
38+
cd api-notifier
39+
npm install
40+
# ou "pnpm install" si vous utilisez pnpm
41+
```
42+
43+
3. Créer un fichier `.env` à la racine du projet, et y ajouter les variables suivantes :
44+
```sh
45+
SUPABASE_LINK=https://****.supabase.co
46+
SUPABASE_PUBLIC_KEY=<longue clé d'accès l'API, privée contrairement à ce que le nom indique, permet un accès complet à la base de données, voir la partie sur Supabase>
47+
```
48+
49+
4. Lancer l'API
50+
```sh
51+
npm start
52+
# ou vous pouvez utiliser pm2 pour le lancer en arrière plan
53+
pm2 start index.js --name "API - Call Notifier"
54+
```

0 commit comments

Comments
 (0)