LeNavire

👋 Introduction

Bienvenue dans la documentation de l'API Le Navire ! Cette API vous permet de créer des bots personnalisès qui peuvent interagir avec les utilisateurs, gérer des serveurs et automatiser des tâches.

ℹ️

Prérequis

Pour utiliser l'API, vous devez avoir un compte Le Navire et créer un bot depuis le Dashboard Développeur.

Fonctionnalités principales

WebSocket en temps réel - Communication instantanée avec Socket.io
Gestion des messages - Envoi, réception et traitement des messages
événements serveur - Notifications pour les membres, channels, etc.
Permissions - Système de permissions granulaire
Sécurisé - Authentification par token et chiffrement

🔐 Authentification

Chaque bot posséde un token unique qui doit être utilisé pour s'authentifier auprés de l'API.

Obtenir votre token

Créez un bot depuis le Dashboard
Copiez le token généré (format: LN_...)
Gardez ce token secret et ne le partagez jamais

⚠️

Sécurité

Ne commitez jamais votre token dans Git. Utilisez des variables d'environnement ou des fichiers de configuration locaux.

Utilisation du token

JavaScript bot.js

const io = require('socket.io-client');



// Votre token bot (é garder secret !)

const BOT_TOKEN = 'LN_votre_token_ici';



// Connexion avec authentification

const socket = io('https://lenavireclem.com', {

    auth: {

        token: BOT_TOKEN,

        type: 'bot'

    }

});

🤖 Créer votre premier bot

Voici un exemple complet d'un bot simple qui répond "Pong !" aux messages contenant "!ping".

Installation des dépendances

Bash terminal

npm install socket.io-client

Code du bot

JavaScript ping-bot.js

const io = require('socket.io-client');



const BOT_TOKEN = process.env.BOT_TOKEN;

const socket = io('https://lenavireclem.com', {

    auth: { token: BOT_TOKEN, type: 'bot' }

});



socket.on('connect', () => {

    console.log('? Bot connecté !');

});



socket.on('newMessage', (message) => {

    // Ignorer nos propres messages

    if (message.author.isBot) return;

    

    // Répondre aux !ping

    if (message.content === '!ping') {

        socket.emit('sendMessage', {

            serverId: message.serverId,

            channelId: message.channelId,

            content: 'Pong ! 🏓'

        });

    }

});



socket.on('disconnect', () => {

    console.log('? Bot déconnecté');

});



socket.on('error', (error) => {

    console.error('Erreur:', error);

});

Lancer le bot

Bash terminal

BOT_TOKEN=LN_votre_token node ping-bot.js

🔌 Connexion WebSocket

Le Navire utilise Socket.io pour la communication en temps réel entre les clients et le serveur.

Connexion de base

JavaScript

const socket = io('https://lenavireclem.com', {

    auth: {

        token: 'LN_votre_token',

        type: 'bot'

    },

    reconnection: true,

    reconnectionDelay: 1000,

    reconnectionAttempts: 10

});

événements de connexion

événement	Description
`connect`	émis quand la connexion est établie
`disconnect`	émis quand la connexion est perdue
`reconnect`	émis lors d'une reconnexion réussie
`error`	émis en cas d'erreur de connexion

📡 événements API

Liste complète des événements que votre bot peut écouter et émettre.

événements de messages

`newMessage`

émis quand un nouveau message est envoyé dans un channel oé le bot est présent.

socket.on('newMessage', (message) => {

    console.log(message);

    // {

    //   id: "msg_123",

    //   content: "Hello!",

    //   author: { id: "user_456", username: "Alice", isBot: false },

    //   serverId: "srv_789",

    //   channelId: "ch_012",

    //   timestamp: 1709654400000

    // }

});

`messageDeleted`

émis quand un message est supprimé.

socket.on('messageDeleted', (data) => {

    console.log(`Message ${data.messageId} supprimé`);

});

`messageEdited`

émis quand un message est modifié.

socket.on('messageEdited', (data) => {

    console.log(`Nouveau contenu: ${data.newContent}`);

});

événements de serveur

`memberJoined`

émis quand un membre rejoint un serveur.

socket.on('memberJoined', (member) => {

    socket.emit('sendMessage', {

        serverId: member.serverId,

        channelId: member.welcomeChannelId,

        content: `Bienvenue ${member.username} ! 👋`

    });

});

`memberLeft`

émis quand un membre quitte un serveur.

`channelCreated`

émis quand un nouveau channel est cr.

`roleUpdated`

émis quand un réle est modifié.

💬 Gestion des messages

Envoyer un message

socket.emit('sendMessage', {

    serverId: 'srv_123',

    channelId: 'ch_456',

    content: 'Hello World!',

    embeds: [{  // Optionnel

        title: 'Titre de l\'embed',

        description: 'Description',

        color: '#00d9a3',

        fields: [

            { name: 'Champ 1', value: 'Valeur 1', inline: true },

            { name: 'Champ 2', value: 'Valeur 2', inline: true }

        ],

        footer: { text: 'Footer' },

        timestamp: Date.now()

    }]

});

Réactions

// Ajouter une réaction

socket.emit('addReaction', {

    messageId: 'msg_123',

    emoji: '👍'

});



// Supprimer une réaction

socket.emit('removeReaction', {

    messageId: 'msg_123',

    emoji: '👍'

});

Supprimer un message

socket.emit('deleteMessage', {

    messageId: 'msg_123',

    channelId: 'ch_456'

});

🌐 Gestion des serveurs

Obtenir les informations d'un serveur

socket.emit('getServerInfo', { serverId: 'srv_123' }, (serverInfo) => {

    console.log(serverInfo);

    // {

    //   id: "srv_123",

    //   name: "Mon Serveur",

    //   members: [...],

    //   channels: [...],

    //   roles: [...]

    // }

});

Créer un channel

socket.emit('createChannel', {

    serverId: 'srv_123',

    name: 'nouveau-channel',

    type: 'text', // ou 'voice'

    category: 'cat_456' // Optionnel

});

Gérer les réles

// Ajouter un réle é un membre

socket.emit('addRole', {

    serverId: 'srv_123',

    userId: 'user_456',

    roleId: 'role_789'

});



// Retirer un réle

socket.emit('removeRole', {

    serverId: 'srv_123',

    userId: 'user_456',

    roleId: 'role_789'

});

🏓 Exemple: Bot Ping avancé

JavaScript ping-bot-advanced.js

const io = require('socket.io-client');



const socket = io('https://lenavireclem.com', {

    auth: { token: process.env.BOT_TOKEN, type: 'bot' }

});



let startTime;



socket.on('connect', () => {

    console.log('? Bot en ligne !');

    startTime = Date.now();

});



socket.on('newMessage', (msg) => {

    if (msg.author.isBot) return;

    

    if (msg.content === '!ping') {

        const latency = Date.now() - msg.timestamp;

        const uptime = Math.floor((Date.now() - startTime) / 1000);

        

        socket.emit('sendMessage', {

            serverId: msg.serverId,

            channelId: msg.channelId,

            embeds: [{

                title: '🏓 Pong !',

                color: '#00d9a3',

                fields: [

                    { name: 'Latence', value: `${latency}ms`, inline: true },

                    { name: 'Uptime', value: `${uptime}s`, inline: true }

                ],

                timestamp: Date.now()

            }]

        });

    }

});

🛡️ Exemple: Bot de modération

JavaScript moderation-bot.js

const io = require('socket.io-client');



const socket = io('https://lenavireclem.com', {

    auth: { token: process.env.BOT_TOKEN, type: 'bot' }

});



// Liste de mots interdits

const bannedWords = ['spam', 'insulte1', 'insulte2'];

const warnings = new Map();



socket.on('newMessage', (msg) => {

    if (msg.author.isBot) return;

    

    // Vérifier les mots interdits

    const hasBannedWord = bannedWords.some(word => 

        msg.content.toLowerCase().includes(word)

    );

    

    if (hasBannedWord) {

        // Supprimer le message

        socket.emit('deleteMessage', {

            messageId: msg.id,

            channelId: msg.channelId

        });

        

        // Avertir l'utilisateur

        const userWarnings = warnings.get(msg.author.id) || 0;

        warnings.set(msg.author.id, userWarnings + 1);

        

        socket.emit('sendMessage', {

            serverId: msg.serverId,

            channelId: msg.channelId,

            content: `⚠️ ${msg.author.username}, attention au langage ! (${userWarnings + 1}/3)`

        });

        

        // Ban aprés 3 avertissements

        if (userWarnings >= 2) {

            socket.emit('banUser', {

                serverId: msg.serverId,

                userId: msg.author.id,

                reason: 'Trop d\'avertissements'

            });

            warnings.delete(msg.author.id);

        }

    }

});

🎵 Exemple: Bot musique (concept)

ℹ️

Note

Les fonctionnalités audio sont en cours de développement. Cet exemple montre le concept.

const queue = new Map();



socket.on('newMessage', (msg) => {

    if (!msg.content.startsWith('!')) return;

    

    const [command, ...args] = msg.content.slice(1).split(' ');

    

    switch(command) {

        case 'play':

            const url = args[0];

            addToQueue(msg.serverId, url);

            socket.emit('sendMessage', {

                serverId: msg.serverId,

                channelId: msg.channelId,

                content: `🎵 Ajouté à la file d'attente !`

            });

            break;

            

        case 'skip':

            skipSong(msg.serverId);

            break;

            

        case 'queue':

            const songs = queue.get(msg.serverId) || [];

            socket.emit('sendMessage', {

                serverId: msg.serverId,

                channelId: msg.channelId,

                embeds: [{

                    title: '🎵 File d\'attente',

                    description: songs.map((s, i) => 

                        `${i+1}. ${s.title}`

                    ).join('\n')

                }]

            });

            break;

    }

});

📋 Objets de référence

Message Object

{

    id: string,

    content: string,

    author: {

        id: string,

        username: string,

        avatar: string,

        isBot: boolean

    },

    serverId: string,

    channelId: string,

    timestamp: number,

    edited: boolean,

    embeds: Array,

    reactions: Array,

    mentions: Array

}

Server Object

{

    id: string,

    name: string,

    icon: string,

    ownerId: string,

    members: Array,

    channels: Array,

    roles: Array,

    createdAt: number

}

User Object

{

    id: string,

    username: string,

    discriminator: string,

    avatar: string,

    badges: Array,

    createdAt: number,

    isBot: boolean

}

⚠️ Gestion des erreurs

Codes d'erreur courants

Code	Description	Solution
`AUTH_FAILED`	Token invalide ou expiré	Vérifiez votre token dans le dashboard
`RATE_LIMITED`	Trop de requêtes	Attendez avant de réessayer
`PERMISSION_DENIED`	Permissions insuffisantes	Vérifiez les réles du bot
`CHANNEL_NOT_FOUND`	Channel introuvable	Vérifiez l'ID du channel

Gérer les erreurs

socket.on('error', (error) => {

    console.error('Erreur:', error.code, error.message);

    

    switch(error.code) {

        case 'AUTH_FAILED':

            console.error('Token invalide !');

            process.exit(1);

            break;

            

        case 'RATE_LIMITED':

            console.warn('Rate limited, attente...');

            setTimeout(() => retry(), error.retryAfter);

            break;

            

        default:

            console.error('Erreur inconnue:', error);

    }

});

? Bonnes pratiques

1. Gestion des commandes

// ? Mauvais

socket.on('newMessage', (msg) => {

    if (msg.content === '!help') { /* ... */ }

    if (msg.content === '!ping') { /* ... */ }

    // ...

});



// ? Bon

const commands = {

    help: (msg) => { /* ... */ },

    ping: (msg) => { /* ... */ }

};



socket.on('newMessage', (msg) => {

    if (!msg.content.startsWith('!')) return;

    

    const [cmd, ...args] = msg.content.slice(1).split(' ');

    const handler = commands[cmd];

    

    if (handler) handler(msg, args);

});

2. Rate Limiting

ℹ️

Limites API

Messages: 5 par seconde maximum
Connexions: 1 par bot
Requêtes API: 50 par minute

3. Logging

// Utilisez un système de logging

const log = {

    info: (msg) => console.log(`[INFO] ${new Date().toISOString()} - ${msg}`),

    error: (msg) => console.error(`[ERROR] ${new Date().toISOString()} - ${msg}`)

};



socket.on('connect', () => log.info('Bot connecté'));

socket.on('error', (err) => log.error(err.message));

4. Graceful Shutdown

process.on('SIGINT', () => {

    console.log('Arrêt du bot...');

    socket.emit('updateStatus', { status: 'offline' });

    socket.disconnect();

    process.exit(0);

});

5. Variables d'environnement

// .env

BOT_TOKEN=LN_votre_token

PREFIX=!

OWNER_ID=user_123



// bot.js

require('dotenv').config();

const config = {

    token: process.env.BOT_TOKEN,

    prefix: process.env.PREFIX || '!',

    ownerId: process.env.OWNER_ID

};

❓ Besoin d'aide ?

💬

Discord

Rejoignez notre serveur de support

Rejoindre ?

💬

Email

Contactez-nous par email

Envoyer ?

💬

Bug Report

Signalez un bug ou proposez une feature

Signaler ?

Bienvenue sur Le Navire

Retrouve tes amis, navigue vers tes serveurs ou lance une nouvelle aventure.

Chat Serveurs Boutique XP E2E Chiffré

Username#0000

Bienvenue

Boutique LeNavire

Dashboard Développeur

Applications

Aucun bot cr

Créer une Application Bot

Documentation API Bot

🚀 Démarrage Rapide

🔌 Connexion WebSocket

💬 Envoyer des Messages

👂 écouter les événements

Clés API

Aucune clé API

Chargement de la boutique...

Chargement des factures...

📚 Documentation API Le Navire

👋 Introduction

Fonctionnalités principales

🔐 Authentification

Obtenir votre token

Utilisation du token

🤖 Créer votre premier bot

Installation des dépendances

Code du bot

Lancer le bot

🔌 Connexion WebSocket

Connexion de base

événements de connexion

📡 événements API

événements de messages

newMessage

messageDeleted

messageEdited

événements de serveur

memberJoined

memberLeft

channelCreated

roleUpdated

💬 Gestion des messages

Envoyer un message

Réactions

Supprimer un message

🌐 Gestion des serveurs

Obtenir les informations d'un serveur

Créer un channel

Gérer les réles

🏓 Exemple: Bot Ping avancé

🛡️ Exemple: Bot de modération

🎵 Exemple: Bot musique (concept)

📋 Objets de référence

Message Object

Server Object

User Object

⚠️ Gestion des erreurs

Codes d'erreur courants

Gérer les erreurs

? Bonnes pratiques

1. Gestion des commandes

2. Rate Limiting

3. Logging

4. Graceful Shutdown

5. Variables d'environnement

❓ Besoin d'aide ?

Discord

Email

Bug Report

Bienvenue sur Le Navire

Tous mes amis

Demandes d'amis en attente

Ajouter un ami

Personnes bloquées

Créer un groupe

Ajouter des membres

Renommer le groupe

Créer un serveur

Profil

Username#0000

é propos de moi

0 ami(s) en commun

`newMessage`

`messageDeleted`

`messageEdited`

`memberJoined`

`memberLeft`

`channelCreated`

`roleUpdated`