API Reference

The Seculian API allows developers to interact with our marketplace programmatically. Base URL

Authentication

API requests require Firebase Authentication. Include the ID token in the Authorization header:

Authorization: Bearer <your-firebase-id-token>

Endpoints

Create Payment

POST /api/create-payment

Initiates a Paystack payment transaction.

{
  "userId": "string",
  "userEmail": "string",
  "productId": "string",
  "productTitle": "string",
  "amount": number
}

Verify Payment

POST /api/verify-payment

Verifies a completed Paystack payment.

{
  "reference": "string",
  "userId": "string",
  "productId": "string"
}

Download Product

POST /api/download

Returns the code content of a purchased product. Requires authentication.

{
  "userId": "string",
  "productId": "string"
}

Health Check

GET /api/health

Returns API status.

Error Responses

All endpoints return a standard error format:

{
  "success": false,
  "message": "Error description"
}

Rate Limits

API endpoints are rate-limited to prevent abuse. Contact seculian01@gmail.com for higher limits.