Developers

API

Accédez aux données de la plateforme rapgospel.org via notre API REST. Intégrez des morceaux, des événements et des profils dans vos propres applications.

Obtenir un token Contacter l'équipe

Base URL

https://rapgospel.org/api/v1

Toutes les requêtes doivent inclure l'en-tête Accept: application/json. Les requêtes authentifiées nécessitent Authorization: Bearer {token}.

REST API

Standard JSON REST endpoints with predictable resource paths and HTTP status codes.

Authentication

Bearer token authentication via OAuth2. Generate tokens from your account settings.

Rate limiting

1,000 requests per hour for authenticated users. 60 requests per hour for public endpoints.

Versioning

API versioned under /api/v1/. Breaking changes will be announced with a minimum 90-day deprecation window.

Points de terminaison

Référence rapide

GET/api/v1/tracks

List published tracks with pagination and tag filters.

GET/api/v1/tracks/:id

Retrieve a single track by ID or slug.

POST/api/v1/tracks

Upload a new track (authenticated, multipart).

GET/api/v1/playlists

List public playlists.

GET/api/v1/events

List upcoming and past events.

GET/api/v1/events/:id

Retrieve event details.

GET/api/v1/users/:username

Public profile data for a given username.

POST/api/v1/purchases

Create a purchase (authenticated).

GET/api/v1/purchases/:id

Retrieve purchase confirmation.

La documentation complète avec exemples de requêtes et réponses sera disponible prochainement.