API Documentation

Complete RESTful API reference for the Jonosakti platform.

Base URL:https://jonosakti.org/api
Format:JSON
Authentication:JWT Bearer Token (Cookie-based sessions)

Authentication

Endpoints marked with Auth require a valid session. Login via /api/auth/login to receive a session cookie.

Rate Limiting

API requests are rate-limited to 100 requests per minute per IP. Authenticated users get 200 requests per minute.

Errors

Errors return JSON with { error: string }. HTTP status codes: 400 (bad request), 401 (unauthorized), 404 (not found), 500 (server error).

Quick Navigation

Authentication

9 endpoints

User authentication and session management endpoints.

Two-Factor Authentication

5 endpoints

TOTP-based two-factor authentication endpoints.

OAuth Authentication

4 endpoints

Social login with Google and Facebook.

Petitions

6 endpoints

Create and manage petitions for collective action.

Campaigns (Crowdfunding)

4 endpoints

Crowdfunding campaigns for community projects.

Articles

3 endpoints

Community journalism and knowledge sharing.

Forums

3 endpoints

Community discussion forums.

Unions

4 endpoints

Labor union organization and management.

Movements

3 endpoints

Social movements and organizing.

Boycotts

4 endpoints

Consumer boycott campaigns.

Cooperatives

3 endpoints

Worker and community cooperatives.

Mutual Aid Networks

3 endpoints

Community mutual aid and support networks.

Local Businesses

3 endpoints

Support local and ethical businesses.

Courses (Education)

3 endpoints

Educational courses and resources.

Fact Checks

3 endpoints

Community fact-checking and verification.

Data Commons

3 endpoints

Shared community data resources.

Referendums

3 endpoints

Community voting on proposals.

Comments

5 endpoints

Comments on all content types.

Likes & Shares

2 endpoints

Content engagement and sharing.

Bookmarks

2 endpoints

Save content for later.

Reports

1 endpoints

Report inappropriate content.

Users

7 endpoints

User profiles and activity.

Notifications

2 endpoints

User notifications and alerts.

Messages

4 endpoints

Direct messaging between users.

File Upload

2 endpoints

Upload files and images.

AI Features

4 endpoints

AI-powered content assistance.

Platform Stats

1 endpoints

Platform-wide statistics.

Health & Monitoring

2 endpoints

System health checks.

Need Help?

If you have questions about the API or need additional access, please contact us.

Contact Support →

Status

All systems operational

Check /api/health for real-time status