DevTinder API Endpoints Complete Guide to All Routes and Responses

DevTinder API Endpoints Complete Guide

This is a complete reference for all DevTinder API endpoints. Use this as a quick lookup when working on the frontend or debugging API calls.

Authentication Endpoints

POST /api/signup

Create a new user account.

Request:

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "password": "John@1234"
}

Response (201):

{
  "message": "User created",
  "data": {
    "_id": "64abc...",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]"
  }
}

Also sets a token cookie (HTTP-only, 7 days).

Errors: 400 (validation), 409 (duplicate email)

POST /api/login

Authenticate and receive JWT cookie.

Request:

{
  "email": "[email protected]",
  "password": "John@1234"
}

Response (200): Same as signup, with token cookie.

Errors: 401 (invalid credentials)

POST /api/logout

Clear the auth cookie.

Response (200):

{ "message": "Logged out successfully" }

Profile Endpoints

GET /api/profile/view

View the logged-in user's profile.

Response (200):

{
  "data": {
    "_id": "64abc...",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "photoUrl": "https://...",
    "age": 25,
    "gender": "male",
    "about": "Developer",
    "skills": ["React", "Node.js"]
  }
}

PATCH /api/profile/edit

Update profile fields. Only whitelisted fields are accepted.

Request:

{
  "firstName": "Johnny",
  "about": "Full-stack developer",
  "skills": ["React", "Node.js", "MongoDB"]
}

Response (200): Updated user object.

POST /api/profile/photo

Upload a profile photo. Uses multipart/form-data.

Request: FormData with photo field.

Response (200):

{
  "message": "Photo updated",
  "data": { "photoUrl": "https://..." }
}

Feed Endpoints

GET /api/feed?page=1&limit=10

Get a paginated feed of user profiles (excluding connected and requested users).

Response (200):

{
  "data": [
    { "_id": "...", "firstName": "Jane", "lastName": "Smith", "photoUrl": "...", "age": 24, "skills": ["Python"] }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 87,
    "totalPages": 9,
    "hasNextPage": true
  }
}

Connection Request Endpoints

POST /api/request/send/:status/:toUserId

Send a connection request. Status is "interested" or "ignored".

Response (201):

{
  "message": "Connection request sent",
  "data": {
    "_id": "...",
    "fromUserId": "...",
    "toUserId": "...",
    "status": "interested"
  }
}

Errors: 400 (invalid status, self-request), 404 (user not found), 409 (duplicate)

POST /api/request/review/:status/:requestId

Accept or reject a received request. Status is "accepted" or "rejected".

Response (200):

{
  "message": "Connection request accepted",
  "data": { "status": "accepted" }
}

GET /api/requests/received

List pending incoming requests (status: interested).

Response (200):

{
  "data": [
    {
      "_id": "...",
      "fromUserId": { "_id": "...", "firstName": "Jane", "photoUrl": "..." },
      "status": "interested"
    }
  ]
}

GET /api/connections

List all accepted connections.

Response (200):

{
  "data": [
    { "_id": "...", "firstName": "Jane", "lastName": "Smith", "photoUrl": "..." }
  ]
}

Chat Endpoints

GET /api/chat/:targetUserId?page=1&limit=50

Load message history with a specific user.

Response (200):

{
  "data": [
    { "_id": "...", "senderId": "...", "receiverId": "...", "text": "Hello!", "createdAt": "..." }
  ]
}

Socket.io Events

• join:chat Join a chat room with a target user
• message:send Send a message to a target user
• message:received Receive a message from another user
• typing:start Notify the other user that typing started
• typing:stop Notify the other user that typing stopped

The Takeaway

The DevTinder API has endpoints for auth (signup, login, logout), profile (view, edit, photo), feed (paginated), connections (send, review, list), and chat (history). All protected endpoints require the JWT cookie. The response format is consistent: a message, data object, and appropriate HTTP status code.