Developer Documentation
Complete API reference and developer guides to build amazing festival management solutions.
Quick Navigation
Getting Started
Quick Start
The Feston API allows you to programmatically manage festivals, participants, events, and results. All API requests are made over HTTPS and responses are returned in JSON format.
Base URL: https://api.feston.app/v1
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN
API Reference
Authentication
Learn how to authenticate your API requests
POST /auth/login
POST /auth/refresh
POST /auth/logout
Festivals
Manage festivals and their configurations
GET /festivals
POST /festivals
PUT /festivals/:id
DELETE /festivals/:id
Participants
Handle participant registration and management
GET /participants
POST /participants
PUT /participants/:id
Events
Create and manage festival events
GET /events
POST /events
PUT /events/:id
DELETE /events/:id
Results
Submit and retrieve competition results
GET /results
POST /results
PUT /results/:id
Webhooks
Set up real-time notifications for your applications
POST /webhooks
GET /webhooks
DELETE /webhooks/:id
SDKs & Libraries
JavaScript/TypeScript
Official Node.js SDK for Feston API
npm install @feston/sdk
Python
Python SDK for Feston API integration
pip install feston-sdk
PHP
PHP SDK for seamless Feston integration
composer require feston/sdk
Code Examples
Create a Festival
const response = await fetch('https://api.feston.app/v1/festivals', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json',
},
body: JSON.stringify({
name: 'Tech Fest 2025',
description: 'Annual technical festival',
startDate: '2025-03-15',
endDate: '2025-03-17',
institution: 'ABC University'
})
});
const festival = await response.json();
console.log('Festival created:', festival);Register a Participant
const participant = await fetch('https://api.feston.app/v1/participants', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json',
},
body: JSON.stringify({
festivalId: 'fest_123',
name: 'John Doe',
email: 'john@example.com',
institution: 'XYZ College',
events: ['event_1', 'event_2']
})
});