analysis/06-api-and-integrations/

APIs & Integrations

REST API documentation and external integrations

This section documents all REST API endpoints and external service integrations for the MASARUK platform. APIs follow RESTful conventions and are designed for JWT authentication.

API Principles & Versioning

Core API design principles, versioning strategy, and conventions.

api-principles-and-versioning.md

Auth & Users API

Authentication, authorization, and user management endpoints.

auth-and-users-api.md

Trips & Bookings API

Trip management and booking operations endpoints.

trips-and-bookings-api.md

Providers & Resources API

Provider management and resource (hotels, buses, etc.) endpoints.

providers-and-resources-api.md

Payments & Financials API

Payment processing, financial records, and reporting endpoints.

payments-and-financials-api.md

Ad Campaigns API

Advertising campaign management and analytics endpoints.

ad-campaigns-and-marketing-api.md

Notifications API

Push notifications, SMS, and email communication endpoints.

notifications-and-messaging-api.md

External Integrations

HyperPay, STC Pay, Mada, Apple Pay, Google Maps, SMS/Email.

integrations-hyperpay-stcpay-mada-applepay-maps-sms-email.md

API Summary

API Groups

100+

Endpoints

External Integrations

REST

Design Pattern

API Tech Stack

Node.js LTS

Backend Runtime

JWT

Authentication

PostgreSQL

Database

JSON

Response Format