21 KiB
21 KiB
Eventify Master API Inventory
Version: 1.0 | Last Updated: 2026-02-09 | Status: Definitive Reference
1. Auth & Identity
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| AUTH-01 | /api/v1/auth/login/otp/request |
POST | Inbound | App/Web -> Server | Request OTP for phone login | High |
| AUTH-02 | /api/v1/auth/login/otp/verify |
POST | Inbound | App/Web -> Server | Verify OTP and issue tokens | High |
| AUTH-03 | /api/v1/auth/login/password |
POST | Inbound | App/Web -> Server | Email/password login | High |
| AUTH-04 | /api/v1/auth/register |
POST | Inbound | App/Web -> Server | New user registration | High |
| AUTH-05 | /api/v1/auth/logout |
POST | Inbound | App/Web -> Server | Invalidate session/tokens | Medium |
| AUTH-06 | /api/v1/auth/refresh |
POST | Inbound | App/Web -> Server | Refresh access token | High |
| AUTH-07 | /api/v1/auth/forgot-password |
POST | Inbound | App/Web -> Server | Initiate password reset | Medium |
| AUTH-08 | /api/v1/auth/reset-password |
POST | Inbound | App/Web -> Server | Complete password reset | Medium |
| AUTH-09 | /api/v1/auth/mfa/setup |
POST | Inbound | App/Web -> Server | Enable 2FA (TOTP/SMS) | Medium |
| AUTH-10 | /api/v1/auth/mfa/verify |
POST | Inbound | App/Web -> Server | Verify 2FA code | High |
| AUTH-11 | /api/v1/auth/oauth/google |
GET | Inbound | App/Web -> Server | Google OAuth redirect | Medium |
| AUTH-12 | /api/v1/auth/oauth/google/callback |
GET | Inbound | Google -> Server | Google OAuth callback | Medium |
| AUTH-13 | /api/v1/auth/oauth/apple |
GET | Inbound | App -> Server | Apple Sign-In redirect | Medium |
| AUTH-14 | /api/v1/auth/oauth/apple/callback |
POST | Inbound | Apple -> Server | Apple Sign-In callback | Medium |
| AUTH-15 | /api/v1/auth/sessions |
GET | Inbound | App/Web -> Server | List active sessions | Low |
| AUTH-16 | /api/v1/auth/sessions/:id |
DELETE | Inbound | App/Web -> Server | Revoke specific session | Medium |
| AUTH-17 | /api/v1/auth/sessions/all |
DELETE | Inbound | App/Web -> Server | Revoke all sessions (except current) | Medium |
| AUTH-18 | /api/v1/partner/auth/login |
POST | Inbound | Partner -> Server | Partner/Organizer login | High |
| AUTH-19 | /api/v1/admin/auth/login |
POST | Inbound | Control Center -> Server | Admin login | High |
| AUTH-20 | /api/v1/admin/auth/impersonate/:userId |
POST | Inbound | Control Center -> Server | Impersonate user session | High |
2. User Entity (CRUD & Profile)
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| USER-01 | /api/v1/users/me |
GET | Inbound | App/Web -> Server | Get current user profile | High |
| USER-02 | /api/v1/users/me |
PATCH | Inbound | App/Web -> Server | Update profile (name, bio, avatar) | Medium |
| USER-03 | /api/v1/users/me/phone |
PATCH | Inbound | App/Web -> Server | Update phone number | Medium |
| USER-04 | /api/v1/users/me/email |
PATCH | Inbound | App/Web -> Server | Update email address | Medium |
| USER-05 | /api/v1/users/me/preferences |
PATCH | Inbound | App/Web -> Server | Update notification/privacy preferences | Low |
| USER-06 | /api/v1/users/me/avatar |
POST | Inbound | App/Web -> Server | Upload avatar image | Low |
| USER-07 | /api/v1/users/me/delete |
POST | Inbound | App/Web -> Server | Request account deletion (GDPR) | Medium |
| USER-08 | /api/v1/users/:id |
GET | Inbound | App/Web -> Server | Get public user profile | Low |
| USER-09 | /api/v1/users/:id/follow |
POST | Inbound | App -> Server | Follow another user | Low |
| USER-10 | /api/v1/users/:id/unfollow |
POST | Inbound | App -> Server | Unfollow user | Low |
| USER-11 | /api/v1/users/me/followers |
GET | Inbound | App -> Server | List followers | Low |
| USER-12 | /api/v1/users/me/following |
GET | Inbound | App -> Server | List following | Low |
| USER-13 | /api/v1/admin/users |
GET | Inbound | Control Center -> Server | List all users (paginated, filterable) | High |
| USER-14 | /api/v1/admin/users/:id |
GET | Inbound | Control Center -> Server | Get user details (admin view) | High |
| USER-15 | /api/v1/admin/users/:id |
PATCH | Inbound | Control Center -> Server | Update user (admin override) | High |
| USER-16 | /api/v1/admin/users/:id/suspend |
POST | Inbound | Control Center -> Server | Suspend user account | High |
| USER-17 | /api/v1/admin/users/:id/ban |
POST | Inbound | Control Center -> Server | Ban user permanently | High |
| USER-18 | /api/v1/admin/users/:id/reinstate |
POST | Inbound | Control Center -> Server | Reinstate suspended/banned user | High |
| USER-19 | /api/v1/admin/users/:id/notes |
POST | Inbound | Control Center -> Server | Add internal admin note | Low |
| USER-20 | /api/v1/admin/users/:id/tags |
PATCH | Inbound | Control Center -> Server | Update user tags | Low |
3. Events (Discovery, CRUD, Publishing)
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| EVT-01 | /api/v1/events |
GET | Inbound | App/Web -> Server | List/search events (public) | High |
| EVT-02 | /api/v1/events/:id |
GET | Inbound | App/Web -> Server | Get event details | High |
| EVT-03 | /api/v1/events/:id/tickets |
GET | Inbound | App/Web -> Server | Get ticket types for event | High |
| EVT-04 | /api/v1/events/featured |
GET | Inbound | App/Web -> Server | Get featured/promoted events | Medium |
| EVT-05 | /api/v1/events/nearby |
GET | Inbound | App -> Server | Get events near user (geo) | Medium |
| EVT-06 | /api/v1/events/categories |
GET | Inbound | App/Web -> Server | List event categories | Low |
| EVT-07 | /api/v1/events/:id/similar |
GET | Inbound | App/Web -> Server | Get similar events | Low |
| EVT-08 | /api/v1/partner/events |
GET | Inbound | Partner -> Server | List organizer's events | High |
| EVT-09 | /api/v1/partner/events |
POST | Inbound | Partner -> Server | Create new event | High |
| EVT-10 | /api/v1/partner/events/:id |
GET | Inbound | Partner -> Server | Get event details (owner) | High |
| EVT-11 | /api/v1/partner/events/:id |
PATCH | Inbound | Partner -> Server | Update event | High |
| EVT-12 | /api/v1/partner/events/:id |
DELETE | Inbound | Partner -> Server | Delete/cancel event | High |
| EVT-13 | /api/v1/partner/events/:id/publish |
POST | Inbound | Partner -> Server | Publish event (make live) | High |
| EVT-14 | /api/v1/partner/events/:id/unpublish |
POST | Inbound | Partner -> Server | Unpublish/draft event | Medium |
| EVT-15 | /api/v1/partner/events/:id/duplicate |
POST | Inbound | Partner -> Server | Clone event | Low |
| EVT-16 | /api/v1/partner/events/:id/tickets |
POST | Inbound | Partner -> Server | Create ticket type | High |
| EVT-17 | /api/v1/partner/events/:id/tickets/:ticketId |
PATCH | Inbound | Partner -> Server | Update ticket type | High |
| EVT-18 | /api/v1/partner/events/:id/tickets/:ticketId |
DELETE | Inbound | Partner -> Server | Delete ticket type | Medium |
| EVT-19 | /api/v1/admin/events |
GET | Inbound | Control Center -> Server | List all events (admin) | High |
| EVT-20 | /api/v1/admin/events/:id |
PATCH | Inbound | Control Center -> Server | Override event details | High |
| EVT-21 | /api/v1/admin/events/:id/approve |
POST | Inbound | Control Center -> Server | Approve pending event | High |
| EVT-22 | /api/v1/admin/events/:id/reject |
POST | Inbound | Control Center -> Server | Reject pending event | High |
| EVT-23 | /api/v1/admin/events/:id/feature |
POST | Inbound | Control Center -> Server | Feature event on homepage | Medium |
4. Orders & Tickets (Commerce)
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| ORD-01 | /api/v1/orders |
POST | Inbound | App/Web -> Server | Create order (cart checkout) | High |
| ORD-02 | /api/v1/orders/:id |
GET | Inbound | App/Web -> Server | Get order details | High |
| ORD-03 | /api/v1/orders/:id/pay |
POST | Inbound | App/Web -> Server | Initiate payment for order | High |
| ORD-04 | /api/v1/orders/:id/cancel |
POST | Inbound | App/Web -> Server | Cancel pending order | Medium |
| ORD-05 | /api/v1/users/me/orders |
GET | Inbound | App/Web -> Server | List user's orders | High |
| ORD-06 | /api/v1/users/me/tickets |
GET | Inbound | App/Web -> Server | List user's tickets (wallet) | High |
| ORD-07 | /api/v1/tickets/:id |
GET | Inbound | App/Web -> Server | Get ticket details (for wallet) | High |
| ORD-08 | /api/v1/tickets/:id/qr |
GET | Inbound | App -> Server | Get QR code data for ticket | High |
| ORD-09 | /api/v1/tickets/:id/transfer |
POST | Inbound | App -> Server | Transfer ticket to another user | Medium |
| ORD-10 | /api/v1/tickets/:id/accept-transfer |
POST | Inbound | App -> Server | Accept incoming ticket transfer | Medium |
| ORD-11 | /api/v1/partner/orders |
GET | Inbound | Partner -> Server | List orders for organizer's events | High |
| ORD-12 | /api/v1/partner/orders/:id |
GET | Inbound | Partner -> Server | Get order details (organizer) | High |
| ORD-13 | /api/v1/partner/orders/:id/refund |
POST | Inbound | Partner -> Server | Initiate refund | High |
| ORD-14 | /api/v1/partner/attendees |
GET | Inbound | Partner -> Server | List attendees for event | High |
| ORD-15 | /api/v1/admin/orders |
GET | Inbound | Control Center -> Server | List all orders (admin) | High |
| ORD-16 | /api/v1/admin/orders/:id |
GET | Inbound | Control Center -> Server | Get order details (admin) | High |
| ORD-17 | /api/v1/admin/orders/:id/refund |
POST | Inbound | Control Center -> Server | Force refund (admin override) | High |
| ORD-18 | /api/v1/admin/orders/:id/receipt |
GET | Inbound | Control Center -> Server | Generate/download receipt | Medium |
5. Payments & Payouts
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| PAY-01 | /api/v1/payments/razorpay/create-order |
POST | Inbound | App/Web -> Server | Create Razorpay order | High |
| PAY-02 | /api/v1/payments/razorpay/verify |
POST | Inbound | App/Web -> Server | Verify Razorpay payment signature | High |
| PAY-03 | /api/v1/payments/stripe/create-intent |
POST | Inbound | App/Web -> Server | Create Stripe PaymentIntent | High |
| PAY-04 | /api/v1/payments/stripe/confirm |
POST | Inbound | App/Web -> Server | Confirm Stripe payment | High |
| PAY-05 | /api/v1/webhooks/razorpay |
POST | Inbound | Razorpay -> Server | Razorpay webhook events | High |
| PAY-06 | /api/v1/webhooks/stripe |
POST | Inbound | Stripe -> Server | Stripe webhook events | High |
| PAY-07 | /api/v1/partner/payouts |
GET | Inbound | Partner -> Server | List payout history | High |
| PAY-08 | /api/v1/partner/payouts/:id |
GET | Inbound | Partner -> Server | Get payout details | High |
| PAY-09 | /api/v1/partner/bank-account |
GET | Inbound | Partner -> Server | Get linked bank account | High |
| PAY-10 | /api/v1/partner/bank-account |
POST | Inbound | Partner -> Server | Link bank account for payouts | High |
| PAY-11 | /api/v1/partner/bank-account |
PATCH | Inbound | Partner -> Server | Update bank account | High |
| PAY-12 | /api/v1/admin/payouts |
GET | Inbound | Control Center -> Server | List all payouts (admin) | High |
| PAY-13 | /api/v1/admin/payouts/:id/approve |
POST | Inbound | Control Center -> Server | Approve payout | High |
| PAY-14 | /api/v1/admin/payouts/:id/hold |
POST | Inbound | Control Center -> Server | Hold payout | High |
| PAY-15 | /api/v1/admin/payouts/:id/release |
POST | Inbound | Control Center -> Server | Release held payout | High |
| PAY-16 | Razorpay Payout API |
POST | Outbound | Server -> Razorpay | Initiate payout to organizer | High |
| PAY-17 | Stripe Connect Payout |
POST | Outbound | Server -> Stripe | Transfer funds to connected account | High |
6. Operations (Check-in, Scanning, Staff)
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| OPS-01 | /api/v1/partner/scan/validate |
POST | Inbound | Partner App -> Server | Validate scanned QR code | High |
| OPS-02 | /api/v1/partner/scan/checkin |
POST | Inbound | Partner App -> Server | Check-in attendee | High |
| OPS-03 | /api/v1/partner/scan/checkout |
POST | Inbound | Partner App -> Server | Check-out attendee (optional) | Low |
| OPS-04 | /api/v1/partner/events/:id/checkin-stats |
GET | Inbound | Partner -> Server | Get live check-in statistics | Medium |
| OPS-05 | /api/v1/partner/staff |
GET | Inbound | Partner -> Server | List event staff | Medium |
| OPS-06 | /api/v1/partner/staff |
POST | Inbound | Partner -> Server | Invite staff member | Medium |
| OPS-07 | /api/v1/partner/staff/:id |
DELETE | Inbound | Partner -> Server | Remove staff member | Medium |
| OPS-08 | /api/v1/partner/staff/:id/permissions |
PATCH | Inbound | Partner -> Server | Update staff permissions | Medium |
| OPS-09 | /api/v1/staff/auth/login |
POST | Inbound | Staff App -> Server | Staff member login | High |
| OPS-10 | /api/v1/staff/events |
GET | Inbound | Staff App -> Server | List assigned events | Medium |
7. Communication (Email, Push, SMS, Chat)
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| COM-01 | Resend API - Transactional |
POST | Outbound | Server -> Resend | Send order confirmation email | High |
| COM-02 | Resend API - Marketing |
POST | Outbound | Server -> Resend | Send marketing/promo email | Low |
| COM-03 | FCM - Push Notification |
POST | Outbound | Server -> FCM | Send push notification to user | Medium |
| COM-04 | APNs - Push Notification |
POST | Outbound | Server -> APNs | Send iOS push notification | Medium |
| COM-05 | Twilio SMS |
POST | Outbound | Server -> Twilio | Send SMS (OTP, alerts) | High |
| COM-06 | /api/v1/users/me/devices |
POST | Inbound | App -> Server | Register device for push | Medium |
| COM-07 | /api/v1/users/me/devices/:id |
DELETE | Inbound | App -> Server | Unregister device | Low |
| COM-08 | /api/v1/webhooks/resend |
POST | Inbound | Resend -> Server | Email delivery status webhook | Medium |
| COM-09 | /api/v1/webhooks/twilio |
POST | Inbound | Twilio -> Server | SMS delivery status webhook | Medium |
| COM-10 | /api/v1/admin/notifications/send |
POST | Inbound | Control Center -> Server | Send notification to user | Medium |
| COM-11 | /api/v1/admin/notifications/broadcast |
POST | Inbound | Control Center -> Server | Broadcast to user segment | Medium |
| COM-12 | /api/v1/chat/conversations |
GET | Inbound | App -> Server | List user's conversations | Low |
| COM-13 | /api/v1/chat/conversations/:id/messages |
GET | Inbound | App -> Server | Get messages in conversation | Low |
| COM-14 | /api/v1/chat/conversations/:id/messages |
POST | Inbound | App -> Server | Send message | Low |
| COM-15 | WebSocket /ws/chat |
WS | Bidirectional | App <-> Server | Real-time chat connection | Low |
8. Data & Analytics
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| DAT-01 | /api/v1/partner/analytics/overview |
GET | Inbound | Partner -> Server | Get sales overview dashboard | Medium |
| DAT-02 | /api/v1/partner/analytics/sales |
GET | Inbound | Partner -> Server | Get detailed sales data | Medium |
| DAT-03 | /api/v1/partner/analytics/attendees |
GET | Inbound | Partner -> Server | Get attendee demographics | Low |
| DAT-04 | /api/v1/partner/analytics/traffic |
GET | Inbound | Partner -> Server | Get page view/traffic data | Low |
| DAT-05 | /api/v1/partner/export/attendees |
GET | Outbound | Server -> Browser | Export attendee list (CSV) | Medium |
| DAT-06 | /api/v1/partner/export/orders |
GET | Outbound | Server -> Browser | Export orders (CSV) | Medium |
| DAT-07 | /api/v1/admin/analytics/overview |
GET | Inbound | Control Center -> Server | Platform-wide analytics | Medium |
| DAT-08 | /api/v1/admin/analytics/revenue |
GET | Inbound | Control Center -> Server | Revenue breakdown | High |
| DAT-09 | /api/v1/admin/analytics/users |
GET | Inbound | Control Center -> Server | User growth metrics | Medium |
| DAT-10 | /api/v1/admin/export/users |
GET | Outbound | Server -> Browser | Export users (CSV) | Medium |
| DAT-11 | /api/v1/admin/export/orders |
GET | Outbound | Server -> Browser | Export orders (CSV) | Medium |
| DAT-12 | /api/v1/admin/export/payouts |
GET | Outbound | Server -> Browser | Export payouts (CSV) | Medium |
| DAT-13 | /api/v1/admin/audit-logs |
GET | Inbound | Control Center -> Server | Get admin activity logs | High |
9. Third-Party Integrations
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| INT-01 | AWS S3 - Presigned URL |
POST | Outbound | Server -> S3 | Generate upload URL | Medium |
| INT-02 | /api/v1/uploads/presigned |
GET | Inbound | App/Web -> Server | Request presigned URL for upload | Medium |
| INT-03 | Google Maps Geocoding API |
GET | Outbound | Server -> Google | Geocode event address | Low |
| INT-04 | Google Maps Places API |
GET | Outbound | Server -> Google | Autocomplete venue search | Low |
| INT-05 | /api/v1/geo/ip |
GET | Inbound | App/Web -> Server | Get location from IP | Low |
| INT-06 | MaxMind GeoIP |
GET | Internal | Server -> MaxMind DB | IP to location lookup | Low |
| INT-07 | /api/v1/calendar/google/export |
GET | Inbound | App/Web -> Server | Generate Google Calendar link | Low |
| INT-08 | /api/v1/calendar/ical/export |
GET | Inbound | App/Web -> Server | Generate iCal file | Low |
| INT-09 | Sentry - Error Reporting |
POST | Outbound | Server -> Sentry | Log errors | Medium |
| INT-10 | Slack Webhook |
POST | Outbound | Server -> Slack | Alert on critical events | Medium |
| INT-11 | PagerDuty API |
POST | Outbound | Server -> PagerDuty | Trigger on-call alerts | High |
10. Support & Moderation
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| SUP-01 | /api/v1/admin/tickets |
GET | Inbound | Control Center -> Server | List support tickets | Medium |
| SUP-02 | /api/v1/admin/tickets/:id |
GET | Inbound | Control Center -> Server | Get ticket details | Medium |
| SUP-03 | /api/v1/admin/tickets |
POST | Inbound | Control Center -> Server | Create escalation ticket | Medium |
| SUP-04 | /api/v1/admin/tickets/:id/reply |
POST | Inbound | Control Center -> Server | Reply to ticket | Medium |
| SUP-05 | /api/v1/admin/tickets/:id/close |
POST | Inbound | Control Center -> Server | Close ticket | Medium |
| SUP-06 | /api/v1/admin/tickets/:id/assign |
POST | Inbound | Control Center -> Server | Assign ticket to agent | Medium |
| SUP-07 | /api/v1/users/me/tickets |
GET | Inbound | App/Web -> Server | List user's support tickets | Low |
| SUP-08 | /api/v1/users/me/tickets |
POST | Inbound | App/Web -> Server | Create support ticket | Low |
| SUP-09 | /api/v1/admin/moderation/reports |
GET | Inbound | Control Center -> Server | List content reports | Medium |
| SUP-10 | /api/v1/admin/moderation/reports/:id/action |
POST | Inbound | Control Center -> Server | Take action on report | Medium |
11. System & Utilities
| ID | Endpoint / Action Name | Method | Direction | Source -> Target | Purpose | Criticality |
|---|---|---|---|---|---|---|
| SYS-01 | /api/v1/health |
GET | Inbound | Any -> Server | Health check | High |
| SYS-02 | /api/v1/health/db |
GET | Inbound | Internal -> Server | Database connectivity check | High |
| SYS-03 | /api/v1/health/redis |
GET | Inbound | Internal -> Server | Redis connectivity check | High |
| SYS-04 | /api/v1/config/mobile |
GET | Inbound | App -> Server | Get mobile app config (feature flags) | Medium |
| SYS-05 | /api/v1/config/web |
GET | Inbound | Web -> Server | Get web config (feature flags) | Medium |
| SYS-06 | /api/v1/version |
GET | Inbound | Any -> Server | Get API version info | Low |
| SYS-07 | Cron: Payout Processor |
CRON | Internal | Scheduler -> Server | Process pending payouts | High |
| SYS-08 | Cron: Reminder Emails |
CRON | Internal | Scheduler -> Server | Send event reminder emails | Medium |
| SYS-09 | Cron: Expired Orders Cleanup |
CRON | Internal | Scheduler -> Server | Cancel expired pending orders | Medium |
| SYS-10 | Cron: Analytics Aggregation |
CRON | Internal | Scheduler -> Server | Pre-compute analytics | Low |
Summary Statistics
| Category | Total Endpoints |
|---|---|
| Auth & Identity | 20 |
| User Entity | 20 |
| Events | 23 |
| Orders & Tickets | 18 |
| Payments & Payouts | 17 |
| Operations | 10 |
| Communication | 15 |
| Data & Analytics | 13 |
| Third-Party Integrations | 11 |
| Support & Moderation | 10 |
| System & Utilities | 10 |
| TOTAL | 167 |
Note: This inventory represents the definitive API surface for the Eventify ecosystem. All development should reference this document for endpoint naming, method conventions, and integration points.