telegram-badge 1.4.1 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ar.md +28 -23
- package/README.de.md +286 -0
- package/README.es.md +286 -0
- package/README.fr.md +286 -0
- package/README.ja.md +28 -23
- package/README.ko.md +28 -23
- package/README.md +162 -43
- package/README.pt.md +286 -0
- package/README.ru.md +66 -24
- package/README.th.md +28 -23
- package/README.zh.md +33 -28
- package/dist/api/telegram-badge.js +4 -2
- package/dist/tests/telegram-badge.test.js +24 -18
- package/package.json +20 -9
package/README.es.md
ADDED
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
# Generador de Insignias de Telegram
|
|
2
|
+
|
|
3
|
+
**Idiomas:** [🇺🇸 English](README.md) | [🇷🇺 Русский](README.ru.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇵🇹 Português](README.pt.md) | [🇸🇦 العربية](README.ar.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇹🇭 ไทย](README.th.md) | [🇨🇳 中文](README.zh.md)
|
|
4
|
+
|
|
5
|
+
[](https://github.com/chatman-media/telegram-badge/actions)
|
|
6
|
+
[](https://github.com/chatman-media/telegram-badge/actions)
|
|
7
|
+
[](https://www.npmjs.com/package/telegram-badge)
|
|
8
|
+
[](https://jsr.io/@chatman-media/telegram-badge)
|
|
9
|
+
[](https://bundlephobia.com/package/telegram-badge)
|
|
10
|
+
[](https://www.typescriptlang.org/)
|
|
11
|
+
[](https://opensource.org/licenses/MIT)
|
|
12
|
+
|
|
13
|
+
[](https://github.com/chatman-media/telegram-badge)
|
|
14
|
+
[](https://dev.to/chatman-media/show-your-telegram-group-member-count-in-github-readme-46pl)
|
|
15
|
+
[](https://x.com/chatman_media/status/1947399700795244694)
|
|
16
|
+
|
|
17
|
+
Este proyecto genera insignias SVG con el número actual de miembros de tus grupos y canales de Telegram. Perfecto para mostrar la actividad de la comunidad en archivos README de GitHub o en sitios web.
|
|
18
|
+
|
|
19
|
+
**Soporta ambos:**
|
|
20
|
+
- 👥 **Grupos de Telegram** - Comunidades interactivas donde todos los miembros pueden enviar mensajes
|
|
21
|
+
- 📢 **Canales de Telegram** - Canales de difusión donde solo los administradores pueden publicar mensajes
|
|
22
|
+
|
|
23
|
+
Tanto los grupos como los canales usan el mismo endpoint de API y funcionan de manera idéntica con este generador de insignias.
|
|
24
|
+
|
|
25
|
+
## Inicio Rápido
|
|
26
|
+
|
|
27
|
+
Simplemente usa parámetros de URL para generar insignias para cualquier grupo o canal de Telegram:
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
https://telegram-badge.vercel.app/api/telegram-badge?channelId=@tu_canal_o_grupo
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Stack Tecnológico
|
|
38
|
+
|
|
39
|
+
- **Node.js / TypeScript** para desarrollo robusto
|
|
40
|
+
- **API Bot de Telegram** para datos en tiempo real
|
|
41
|
+
- **Vercel (API Serverless)** para disponibilidad global
|
|
42
|
+
- **Jest** para pruebas
|
|
43
|
+
- **Biome** para linting y formateo
|
|
44
|
+
|
|
45
|
+
## Uso
|
|
46
|
+
|
|
47
|
+
### Método Principal: Parámetros de URL (¡Sin Configuración Requerida!)
|
|
48
|
+
|
|
49
|
+
Simplemente agrega tu ID de grupo o canal de Telegram a la URL:
|
|
50
|
+
|
|
51
|
+
```markdown
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Funciona con:**
|
|
56
|
+
- Canales públicos: `@tu_canal`
|
|
57
|
+
- Grupos públicos: `@tu_grupo`
|
|
58
|
+
- Grupos/canales privados: `-1001234567890` (ID de chat numérico)
|
|
59
|
+
|
|
60
|
+
¡Eso es todo! No se necesita despliegue ni token de bot para grupos y canales públicos.
|
|
61
|
+
|
|
62
|
+
### Método Alternativo: Despliegue Auto-Hospedado
|
|
63
|
+
|
|
64
|
+
Para canales privados o despliegues personalizados:
|
|
65
|
+
|
|
66
|
+
1. **Clonar el repositorio:**
|
|
67
|
+
```bash
|
|
68
|
+
git clone https://github.com/chatman-media/telegram-badge.git
|
|
69
|
+
cd telegram-badge
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
2. **Instalar dependencias:**
|
|
73
|
+
```bash
|
|
74
|
+
npm install
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
3. **Configurar variables de entorno:**
|
|
78
|
+
```bash
|
|
79
|
+
cp .env.example .env
|
|
80
|
+
# Edita .env con tu BOT_TOKEN
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
4. **Desplegar en Vercel:**
|
|
84
|
+
```bash
|
|
85
|
+
npm run deploy
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Parámetros de Estilo
|
|
89
|
+
|
|
90
|
+
Personaliza la apariencia de tu insignia:
|
|
91
|
+
|
|
92
|
+
| Parámetro | Descripción | Por defecto | Ejemplo |
|
|
93
|
+
|-----------|-------------|-------------|---------|
|
|
94
|
+
| `style` | Estilo de insignia | `flat` | `flat`, `plastic`, `flat-square`, `for-the-badge`, `social` |
|
|
95
|
+
| `label` | Texto izquierdo | `Members` | `Miembros`, `Suscriptores` |
|
|
96
|
+
| `color` | Color derecho | `2AABEE` | `brightgreen`, `red`, `blue` |
|
|
97
|
+
| `labelColor` | Color izquierdo | `555555` | `orange`, `lightgrey` |
|
|
98
|
+
| `logo` | Agregar logo | `telegram` | `telegram`, `discord` |
|
|
99
|
+
| `logoColor` | Color del logo | `white` | `white`, `black` |
|
|
100
|
+
|
|
101
|
+
### Estilos de Insignia
|
|
102
|
+
|
|
103
|
+
| Estilo | Ejemplo |
|
|
104
|
+
|--------|---------|
|
|
105
|
+
| `flat` |  |
|
|
106
|
+
| `plastic` |  |
|
|
107
|
+
| `flat-square` |  |
|
|
108
|
+
| `for-the-badge` |  |
|
|
109
|
+
| `social` |  |
|
|
110
|
+
|
|
111
|
+
### Ejemplos de Uso
|
|
112
|
+
|
|
113
|
+
```markdown
|
|
114
|
+
<!-- Insignia básica -->
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
<!-- Estilo personalizado -->
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
<!-- Con logo -->
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Características
|
|
125
|
+
|
|
126
|
+
- 🔄 **Número de miembros en tiempo real** - Datos siempre actualizados
|
|
127
|
+
- 🎨 **Completamente personalizable** - Colores, estilos, etiquetas
|
|
128
|
+
- 🚀 **Auto-hospedable** - Despliega en tu propia infraestructura
|
|
129
|
+
- 📦 **Paquete NPM disponible** - Fácil integración en tus proyectos
|
|
130
|
+
- 🌐 **CDN Global** - Tiempos de respuesta rápidos en todo el mundo
|
|
131
|
+
- 🔒 **API Segura** - Sin almacenamiento de datos sensibles
|
|
132
|
+
- 📱 **Diseño Responsivo** - Funciona en todos los dispositivos
|
|
133
|
+
- 🎯 **Configuración Cero** - Funciona inmediatamente
|
|
134
|
+
|
|
135
|
+
## Uso de la API
|
|
136
|
+
|
|
137
|
+
### Como paquete NPM:
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
npm install @chatman-media/telegram-badge
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
```typescript
|
|
144
|
+
import badgeHandler from "@chatman-media/telegram-badge";
|
|
145
|
+
|
|
146
|
+
// Usa en tu función serverless
|
|
147
|
+
export default badgeHandler;
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### Como paquete Deno/JSR:
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
# Usando JSR
|
|
154
|
+
deno add @chatman-media/telegram-badge
|
|
155
|
+
|
|
156
|
+
# O importa directamente
|
|
157
|
+
import badgeHandler from "jsr:@chatman-media/telegram-badge";
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
```typescript
|
|
161
|
+
import badgeHandler from "@chatman-media/telegram-badge";
|
|
162
|
+
|
|
163
|
+
// Usa en tu función serverless de Deno
|
|
164
|
+
export default badgeHandler;
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
### Llamadas directas a la API:
|
|
168
|
+
|
|
169
|
+
```typescript
|
|
170
|
+
GET /api/telegram-badge?channelId=@tu_canal&style=flat&label=Miembros&color=2AABEE&labelColor=555555
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## Pruebas
|
|
174
|
+
|
|
175
|
+
Ejecutar la suite de pruebas:
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
npm test
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Ejecutar verificación de tipos:
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
npm run type-check
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
Construir el proyecto:
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
npm run build
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
## FAQ
|
|
194
|
+
|
|
195
|
+
### ¿Cuál es la diferencia entre grupos y canales de Telegram?
|
|
196
|
+
|
|
197
|
+
**Grupos de Telegram:**
|
|
198
|
+
- 👥 Comunidades interactivas donde todos los miembros pueden enviar mensajes
|
|
199
|
+
- Los miembros pueden verse entre sí e interactuar
|
|
200
|
+
- Pueden tener hasta 200,000 miembros
|
|
201
|
+
- Ejemplo: `@tu_grupo`
|
|
202
|
+
|
|
203
|
+
**Canales de Telegram:**
|
|
204
|
+
- 📢 Canales de difusión donde solo los administradores pueden publicar mensajes
|
|
205
|
+
- Los suscriptores no pueden verse entre sí
|
|
206
|
+
- Pueden tener suscriptores ilimitados
|
|
207
|
+
- Ejemplo: `@tu_canal`
|
|
208
|
+
|
|
209
|
+
**Para este generador de insignias:** ¡Tanto los grupos como los canales funcionan exactamente igual! La API Bot de Telegram los trata de manera idéntica para obtener el número de miembros/suscriptores.
|
|
210
|
+
|
|
211
|
+
### ¿Cómo encuentro mi ID de grupo/canal?
|
|
212
|
+
|
|
213
|
+
**Para grupos/canales públicos:**
|
|
214
|
+
- Usa el nombre de usuario: `@tu_canal` o `@tu_grupo`
|
|
215
|
+
|
|
216
|
+
**Para grupos/canales privados:**
|
|
217
|
+
- Usa un bot como [@userinfobot](https://t.me/userinfobot)
|
|
218
|
+
- Reenvía cualquier mensaje de tu grupo/canal al bot
|
|
219
|
+
- Mostrará el ID del chat (como `-1001234567890`)
|
|
220
|
+
|
|
221
|
+
### ¿Necesito un token de bot?
|
|
222
|
+
|
|
223
|
+
**No se necesita token de bot** para grupos y canales públicos cuando usas el servicio hospedado en `telegram-badge.vercel.app`.
|
|
224
|
+
|
|
225
|
+
**Token de bot requerido** solo para:
|
|
226
|
+
- Grupos/canales privados
|
|
227
|
+
- Despliegues auto-hospedados
|
|
228
|
+
|
|
229
|
+
## Contribuir
|
|
230
|
+
|
|
231
|
+
1. Haz fork del repositorio
|
|
232
|
+
2. Crea tu rama de característica (`git checkout -b feature/amazing-feature`)
|
|
233
|
+
3. Confirma tus cambios (`git commit -m 'Add some amazing feature'`)
|
|
234
|
+
4. Empuja a la rama (`git push origin feature/amazing-feature`)
|
|
235
|
+
5. Abre un Pull Request
|
|
236
|
+
|
|
237
|
+
## Suscribirse
|
|
238
|
+
|
|
239
|
+
[](https://stackoverflow.com/users/724036/alexander-kireyev)
|
|
240
|
+
|
|
241
|
+
[](https://github.com/chatman-media)
|
|
242
|
+
[](https://www.tiktok.com/@chatman.media)
|
|
243
|
+
[](https://www.twitch.tv/chatman1984)
|
|
244
|
+
[](https://www.youtube.com/@chatman-media)
|
|
245
|
+
[](https://t.me/alexanderkireyev)
|
|
246
|
+
[](https://x.com/chatman_media)
|
|
247
|
+
|
|
248
|
+
## Soporte 💝🚀
|
|
249
|
+
|
|
250
|
+
- **BTC:** 14s9Y9Rb2CUWHSAatiQMhfkpx1MWXofUzw
|
|
251
|
+
- **TON:** UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj
|
|
252
|
+
- **NOT:** UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj
|
|
253
|
+
- **ETH:** 0x286D65151b622dCC16624cEd8463FDa45585fd60
|
|
254
|
+
|
|
255
|
+
<div align="center">
|
|
256
|
+
<table>
|
|
257
|
+
<tr>
|
|
258
|
+
<td><img src="public/btc.png" alt="BTC" height="185" /></td>
|
|
259
|
+
<td><img src="public/ton.png" alt="TON" height="185" /></td>
|
|
260
|
+
<td><img src="public/not.png" alt="NOT" height="185" /></td>
|
|
261
|
+
<td><img src="public/eth.png" alt="ETH" height="185" /></td>
|
|
262
|
+
</tr>
|
|
263
|
+
</table>
|
|
264
|
+
</div>
|
|
265
|
+
|
|
266
|
+
## Star History
|
|
267
|
+
|
|
268
|
+
<a href="https://www.star-history.com/#chatman-media/telegram-badge&Date">
|
|
269
|
+
<picture>
|
|
270
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=chatman-media/telegram-badge&type=Date&theme=dark" />
|
|
271
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=chatman-media/telegram-badge&type=Date" />
|
|
272
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=chatman-media/telegram-badge&type=Date" />
|
|
273
|
+
</picture>
|
|
274
|
+
</a>
|
|
275
|
+
|
|
276
|
+
## Repo Activity
|
|
277
|
+
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
## Licencia
|
|
281
|
+
|
|
282
|
+
Este proyecto está licenciado bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para más detalles.
|
|
283
|
+
|
|
284
|
+
---
|
|
285
|
+
|
|
286
|
+
Hecho con ❤️ por [Chatman Media](https://github.com/chatman-media)
|
package/README.fr.md
ADDED
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
# Générateur de Badge Telegram
|
|
2
|
+
|
|
3
|
+
**Langues :** [🇺🇸 English](README.md) | [🇷🇺 Русский](README.ru.md) | [🇩🇪 Deutsch](README.de.md) | [🇪🇸 Español](README.es.md) | [🇵🇹 Português](README.pt.md) | [🇸🇦 العربية](README.ar.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇹🇭 ไทย](README.th.md) | [🇨🇳 中文](README.zh.md)
|
|
4
|
+
|
|
5
|
+
[](https://github.com/chatman-media/telegram-badge/actions)
|
|
6
|
+
[](https://github.com/chatman-media/telegram-badge/actions)
|
|
7
|
+
[](https://www.npmjs.com/package/telegram-badge)
|
|
8
|
+
[](https://jsr.io/@chatman-media/telegram-badge)
|
|
9
|
+
[](https://bundlephobia.com/package/telegram-badge)
|
|
10
|
+
[](https://www.typescriptlang.org/)
|
|
11
|
+
[](https://opensource.org/licenses/MIT)
|
|
12
|
+
|
|
13
|
+
[](https://github.com/chatman-media/telegram-badge)
|
|
14
|
+
[](https://dev.to/chatman-media/show-your-telegram-group-member-count-in-github-readme-46pl)
|
|
15
|
+
[](https://x.com/chatman_media/status/1947399700795244694)
|
|
16
|
+
|
|
17
|
+
Ce projet génère des badges SVG avec le nombre actuel de membres de vos groupes et chaînes Telegram. Parfait pour afficher l'activité de la communauté dans les fichiers README GitHub ou sur les sites web.
|
|
18
|
+
|
|
19
|
+
**Prend en charge les deux :**
|
|
20
|
+
- 👥 **Groupes Telegram** - Communautés interactives où tous les membres peuvent envoyer des messages
|
|
21
|
+
- 📢 **Chaînes Telegram** - Chaînes de diffusion où seuls les administrateurs peuvent publier des messages
|
|
22
|
+
|
|
23
|
+
Les groupes et les chaînes utilisent le même point de terminaison API et fonctionnent de manière identique avec ce générateur de badges.
|
|
24
|
+
|
|
25
|
+
## Démarrage Rapide
|
|
26
|
+
|
|
27
|
+
Utilisez simplement les paramètres d'URL pour générer des badges pour n'importe quel groupe ou chaîne Telegram :
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
https://telegram-badge.vercel.app/api/telegram-badge?channelId=@votre_chaine_ou_groupe
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Stack Technologique
|
|
38
|
+
|
|
39
|
+
- **Node.js / TypeScript** pour un développement robuste
|
|
40
|
+
- **API Bot Telegram** pour des données en temps réel
|
|
41
|
+
- **Vercel (API Serverless)** pour une disponibilité mondiale
|
|
42
|
+
- **Jest** pour les tests
|
|
43
|
+
- **Biome** pour le linting et le formatage
|
|
44
|
+
|
|
45
|
+
## Utilisation
|
|
46
|
+
|
|
47
|
+
### Méthode Principale : Paramètres d'URL (Aucune Configuration Requise !)
|
|
48
|
+
|
|
49
|
+
Ajoutez simplement votre ID de groupe ou chaîne Telegram à l'URL :
|
|
50
|
+
|
|
51
|
+
```markdown
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Fonctionne avec :**
|
|
56
|
+
- Chaînes publiques : `@votre_chaine`
|
|
57
|
+
- Groupes publics : `@votre_groupe`
|
|
58
|
+
- Groupes/chaînes privés : `-1001234567890` (ID de chat numérique)
|
|
59
|
+
|
|
60
|
+
C'est tout ! Aucun déploiement, aucun token de bot nécessaire pour les groupes et chaînes publics.
|
|
61
|
+
|
|
62
|
+
### Méthode Alternative : Déploiement Auto-Hébergé
|
|
63
|
+
|
|
64
|
+
Pour les chaînes privées ou les déploiements personnalisés :
|
|
65
|
+
|
|
66
|
+
1. **Cloner le dépôt :**
|
|
67
|
+
```bash
|
|
68
|
+
git clone https://github.com/chatman-media/telegram-badge.git
|
|
69
|
+
cd telegram-badge
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
2. **Installer les dépendances :**
|
|
73
|
+
```bash
|
|
74
|
+
npm install
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
3. **Configurer les variables d'environnement :**
|
|
78
|
+
```bash
|
|
79
|
+
cp .env.example .env
|
|
80
|
+
# Modifiez .env avec votre BOT_TOKEN
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
4. **Déployer sur Vercel :**
|
|
84
|
+
```bash
|
|
85
|
+
npm run deploy
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Paramètres de Style
|
|
89
|
+
|
|
90
|
+
Personnalisez l'apparence de votre badge :
|
|
91
|
+
|
|
92
|
+
| Paramètre | Description | Défaut | Exemple |
|
|
93
|
+
|-----------|-------------|--------|---------|
|
|
94
|
+
| `style` | Style du badge | `flat` | `flat`, `plastic`, `flat-square`, `for-the-badge`, `social` |
|
|
95
|
+
| `label` | Texte de gauche | `Members` | `Membres`, `Abonnés` |
|
|
96
|
+
| `color` | Couleur de droite | `2AABEE` | `brightgreen`, `red`, `blue` |
|
|
97
|
+
| `labelColor` | Couleur de gauche | `555555` | `orange`, `lightgrey` |
|
|
98
|
+
| `logo` | Ajouter un logo | `telegram` | `telegram`, `discord` |
|
|
99
|
+
| `logoColor` | Couleur du logo | `white` | `white`, `black` |
|
|
100
|
+
|
|
101
|
+
### Styles de Badge
|
|
102
|
+
|
|
103
|
+
| Style | Exemple |
|
|
104
|
+
|-------|---------|
|
|
105
|
+
| `flat` |  |
|
|
106
|
+
| `plastic` |  |
|
|
107
|
+
| `flat-square` |  |
|
|
108
|
+
| `for-the-badge` |  |
|
|
109
|
+
| `social` |  |
|
|
110
|
+
|
|
111
|
+
### Exemples d'Utilisation
|
|
112
|
+
|
|
113
|
+
```markdown
|
|
114
|
+
<!-- Badge basique -->
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
<!-- Style personnalisé -->
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
<!-- Avec logo -->
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Fonctionnalités
|
|
125
|
+
|
|
126
|
+
- 🔄 **Nombre de membres en temps réel** - Données toujours à jour
|
|
127
|
+
- 🎨 **Entièrement personnalisable** - Couleurs, styles, étiquettes
|
|
128
|
+
- 🚀 **Auto-hébergeable** - Déployez sur votre propre infrastructure
|
|
129
|
+
- 📦 **Package NPM disponible** - Intégration facile dans vos projets
|
|
130
|
+
- 🌐 **CDN Global** - Temps de réponse rapides dans le monde entier
|
|
131
|
+
- 🔒 **API Sécurisée** - Aucun stockage de données sensibles
|
|
132
|
+
- 📱 **Design Responsive** - Fonctionne sur tous les appareils
|
|
133
|
+
- 🎯 **Configuration Zéro** - Fonctionne immédiatement
|
|
134
|
+
|
|
135
|
+
## Utilisation de l'API
|
|
136
|
+
|
|
137
|
+
### En tant que package NPM :
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
npm install @chatman-media/telegram-badge
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
```typescript
|
|
144
|
+
import badgeHandler from "@chatman-media/telegram-badge";
|
|
145
|
+
|
|
146
|
+
// Utilisez dans votre fonction serverless
|
|
147
|
+
export default badgeHandler;
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### En tant que package Deno/JSR :
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
# Avec JSR
|
|
154
|
+
deno add @chatman-media/telegram-badge
|
|
155
|
+
|
|
156
|
+
# Ou importez directement
|
|
157
|
+
import badgeHandler from "jsr:@chatman-media/telegram-badge";
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
```typescript
|
|
161
|
+
import badgeHandler from "@chatman-media/telegram-badge";
|
|
162
|
+
|
|
163
|
+
// Utilisez dans votre fonction serverless Deno
|
|
164
|
+
export default badgeHandler;
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
### Appels API directs :
|
|
168
|
+
|
|
169
|
+
```typescript
|
|
170
|
+
GET /api/telegram-badge?channelId=@votre_chaine&style=flat&label=Membres&color=2AABEE&labelColor=555555
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## Tests
|
|
174
|
+
|
|
175
|
+
Exécuter la suite de tests :
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
npm test
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Exécuter la vérification de type :
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
npm run type-check
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
Construire le projet :
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
npm run build
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
## FAQ
|
|
194
|
+
|
|
195
|
+
### Quelle est la différence entre les groupes et chaînes Telegram ?
|
|
196
|
+
|
|
197
|
+
**Groupes Telegram :**
|
|
198
|
+
- 👥 Communautés interactives où tous les membres peuvent envoyer des messages
|
|
199
|
+
- Les membres peuvent se voir et interagir entre eux
|
|
200
|
+
- Peuvent avoir jusqu'à 200 000 membres
|
|
201
|
+
- Exemple : `@votre_groupe`
|
|
202
|
+
|
|
203
|
+
**Chaînes Telegram :**
|
|
204
|
+
- 📢 Chaînes de diffusion où seuls les administrateurs peuvent publier des messages
|
|
205
|
+
- Les abonnés ne peuvent pas se voir entre eux
|
|
206
|
+
- Peuvent avoir un nombre illimité d'abonnés
|
|
207
|
+
- Exemple : `@votre_chaine`
|
|
208
|
+
|
|
209
|
+
**Pour ce générateur de badges :** Les groupes et chaînes fonctionnent exactement de la même manière ! L'API Bot Telegram les traite de manière identique pour obtenir le nombre de membres/abonnés.
|
|
210
|
+
|
|
211
|
+
### Comment trouver mon ID de groupe/chaîne ?
|
|
212
|
+
|
|
213
|
+
**Pour les groupes/chaînes publics :**
|
|
214
|
+
- Utilisez le nom d'utilisateur : `@votre_chaine` ou `@votre_groupe`
|
|
215
|
+
|
|
216
|
+
**Pour les groupes/chaînes privés :**
|
|
217
|
+
- Utilisez un bot comme [@userinfobot](https://t.me/userinfobot)
|
|
218
|
+
- Transférez n'importe quel message de votre groupe/chaîne au bot
|
|
219
|
+
- Il affichera l'ID du chat (comme `-1001234567890`)
|
|
220
|
+
|
|
221
|
+
### Ai-je besoin d'un token de bot ?
|
|
222
|
+
|
|
223
|
+
**Aucun token de bot nécessaire** pour les groupes et chaînes publics lors de l'utilisation du service hébergé sur `telegram-badge.vercel.app`.
|
|
224
|
+
|
|
225
|
+
**Token de bot requis** uniquement pour :
|
|
226
|
+
- Les groupes/chaînes privés
|
|
227
|
+
- Les déploiements auto-hébergés
|
|
228
|
+
|
|
229
|
+
## Contribution
|
|
230
|
+
|
|
231
|
+
1. Forkez le dépôt
|
|
232
|
+
2. Créez votre branche de fonctionnalité (`git checkout -b feature/amazing-feature`)
|
|
233
|
+
3. Commitez vos changements (`git commit -m 'Add some amazing feature'`)
|
|
234
|
+
4. Poussez vers la branche (`git push origin feature/amazing-feature`)
|
|
235
|
+
5. Ouvrez une Pull Request
|
|
236
|
+
|
|
237
|
+
## S'abonner
|
|
238
|
+
|
|
239
|
+
[](https://stackoverflow.com/users/724036/alexander-kireyev)
|
|
240
|
+
|
|
241
|
+
[](https://github.com/chatman-media)
|
|
242
|
+
[](https://www.tiktok.com/@chatman.media)
|
|
243
|
+
[](https://www.twitch.tv/chatman1984)
|
|
244
|
+
[](https://www.youtube.com/@chatman-media)
|
|
245
|
+
[](https://t.me/alexanderkireyev)
|
|
246
|
+
[](https://x.com/chatman_media)
|
|
247
|
+
|
|
248
|
+
## Support 💝🚀
|
|
249
|
+
|
|
250
|
+
- **BTC:** 14s9Y9Rb2CUWHSAatiQMhfkpx1MWXofUzw
|
|
251
|
+
- **TON:** UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj
|
|
252
|
+
- **NOT:** UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj
|
|
253
|
+
- **ETH:** 0x286D65151b622dCC16624cEd8463FDa45585fd60
|
|
254
|
+
|
|
255
|
+
<div align="center">
|
|
256
|
+
<table>
|
|
257
|
+
<tr>
|
|
258
|
+
<td><img src="public/btc.png" alt="BTC" height="185" /></td>
|
|
259
|
+
<td><img src="public/ton.png" alt="TON" height="185" /></td>
|
|
260
|
+
<td><img src="public/not.png" alt="NOT" height="185" /></td>
|
|
261
|
+
<td><img src="public/eth.png" alt="ETH" height="185" /></td>
|
|
262
|
+
</tr>
|
|
263
|
+
</table>
|
|
264
|
+
</div>
|
|
265
|
+
|
|
266
|
+
## Star History
|
|
267
|
+
|
|
268
|
+
<a href="https://www.star-history.com/#chatman-media/telegram-badge&Date">
|
|
269
|
+
<picture>
|
|
270
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=chatman-media/telegram-badge&type=Date&theme=dark" />
|
|
271
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=chatman-media/telegram-badge&type=Date" />
|
|
272
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=chatman-media/telegram-badge&type=Date" />
|
|
273
|
+
</picture>
|
|
274
|
+
</a>
|
|
275
|
+
|
|
276
|
+
## Repo Activity
|
|
277
|
+
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
## Licence
|
|
281
|
+
|
|
282
|
+
Ce projet est sous licence MIT - voir le fichier [LICENSE](LICENSE) pour plus de détails.
|
|
283
|
+
|
|
284
|
+
---
|
|
285
|
+
|
|
286
|
+
Fait avec ❤️ par [Chatman Media](https://github.com/chatman-media)
|