Skip to main content

Register Push Token (v1)

Method & Path​

POST /api/v1/public/push-tokens

Description​

Register or refresh a mobile device's Expo push token for the Store App.

Persona Access: Customer (client).

note

Backend path: /v1/public/push-tokens (served via api.placio.app).

Authentication​

None: Public endpoint.

Headers​

  • Content-Type: application/json

Request Body​

{
  "token": "ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]",
  "platform": "ios",
  "appVersion": "1.0.0",
  "deviceModel": "iPhone14,2",
  "fakeName": "نادر"
}

Schema Notes

  • token (string, required): Expo push token.
  • platform (string, required): ios | android | web.
  • appVersion (string, optional): App version reported by the device.
  • deviceModel (string, optional): Device model identifier.
  • fakeName (string, required): Fixed display name used by the Store App.

Response 201 Created​

{
  "pushToken": {
    "id": "65f0c46be27f35b15ccfbd7a",
    "token": "ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]",
    "platform": "ios",
    "appVersion": "1.0.0",
    "deviceModel": "iPhone14,2",
    "fakeName": "نادر",
    "lastSeenAt": "2026-01-22T00:00:00.000Z",
    "createdAt": "2026-01-22T00:00:00.000Z",
    "updatedAt": "2026-01-22T00:00:00.000Z"
  }
}

Common Errors​

  • 400 Bad Request: Invalid payload format.
  • 422 Unprocessable Entity: Validation failed.
  • 500 Internal Server Error: Unexpected server error.