Développeurs

Intégrez Rafflebay dans vos applications avec notre API REST et nos SDKs. Créez des expériences de loterie innovantes sur la blockchain.

Documentation API GitHub

Démarrage rapide

1. Obtenez une clé API

Créez un compte développeur et générez votre clé API depuis votre dashboard.

S'inscrire →

2. Installez le SDK

Utilisez npm, pip ou votre gestionnaire de paquets préféré.

npm install @rafflebay/sdk

3. Première requête

Commencez à intégrer les loteries Rafflebay dans votre application.

Voir les exemples →

Référence API

Base URL

https://api.rafflebay.com/v1

Toutes les requêtes doivent inclure votre clé API dans le header Authorization

Endpoints principaux

GET/api/v1/lotteries

Liste toutes les loteries actives

GET/api/v1/lotteries/:id

Détails d'une loterie spécifique

POST/api/v1/tickets/purchase

Acheter des tickets pour une loterie

GET/api/v1/users/:id/tickets

Historique des tickets d'un utilisateur

GET/api/v1/blockchain/verify/:txHash

Vérifier une transaction blockchain

Documentation complète →

Exemples de code

Initialisation du SDK

import { RafflebaySDK } from '@rafflebay/sdk';

const rafflebay = new RafflebaySDK({
  apiKey: 'YOUR_API_KEY',
  network: 'polygon' // ou 'polygon-testnet' pour les tests
});

// Vérifier la connexion
const status = await rafflebay.getStatus();
console.log('API Status:', status);

Lister les loteries actives

// Récupérer toutes les loteries actives
const lotteries = await rafflebay.lotteries.list({
  status: 'ACTIVE',
  limit: 10,
  orderBy: 'endDate'
});

// Afficher les détails
lotteries.forEach(lottery => {
  console.log(`${lottery.title} - ${lottery.ticketPrice} EURC`);
});

Acheter des tickets

// Acheter 5 tickets pour une loterie
const purchase = await rafflebay.tickets.purchase({
  lotteryId: 'lottery_123',
  quantity: 5,
  walletAddress: '0xYourWallet...'
});

// Vérifier la transaction
console.log('Transaction hash:', purchase.transactionHash);
console.log('Ticket IDs:', purchase.ticketIds);