User Translations API

Get translations preference of a specific user

NOTE: user_id in api path doesn't matter, system will authenticate using auth headers and send translation preferences of authenticated user.

Path Parameters

user_id string required

user id

Query Parameters

client_auth_token string required

Client API token

Header Parameters

access-token string required

user access token

client string required

client access token

expiry string required
timestamp of token expiry
Example: 1531315250
token-type string required
access token type
Example: Bearer
uid string required
user uid
Example: user@quranreflect.com

Responses

• 200
• 401
• 500

---

OK

Response Headers

application/json

Schema

Example (from schema)

Example 1

Example

---

Schema

success boolean
translations object[]
Array [
id integer
name string
created_at string
updated_at string
language_id integer
default boolean
]

{
  "success": true,
  "translations": [
    {
      "id": 0,
      "name": "string",
      "created_at": "string",
      "updated_at": "string",
      "language_id": 0,
      "default": true
    }
  ]
}

{
  "success": true,
  "translations": [
    {
      "id": 0,
      "name": "Urdu",
      "created_at": "2021-11-16T17:52:31.000Z",
      "updated_at": "2021-11-16T17:52:31.000Z",
      "language_id": 5,
      "default": true
    }
  ]
}

{
  "success": true,
  "translations": [
    {
      "id": 1,
      "name": "Arabic",
      "created_at": "2016-11-19T19:58:34.000Z",
      "updated_at": "2017-02-07T11:07:17.000Z",
      "language_id": 1,
      "default": true
    },
    {
      "id": 5,
      "name": "Saheeh International",
      "created_at": "2017-02-07T08:42:38.000Z",
      "updated_at": "2017-02-07T09:13:01.000Z",
      "language_id": 2,
      "default": true
    }
  ]
}

Unauthorized response, api will respond with this 401 eithr user is not logged in or do not have permission to perform some action. Like creating a post in a room, but user is not member of room.

System will also return 401 if api token is missing or invlaid.

application/json

Schema

Example (from schema)

not logged in

missing or invalid api key

---

Schema

errors string[]
status integer

Default value: 401

success boolean

Default value: false

{
  "errors": [
    "string"
  ],
  "status": 401,
  "success": false
}

{
  "errors": [
    "You need to sign in or sign up before continuing."
  ],
  "success": false
}

{
  "message": "You don't have permission!",
  "status": 401,
  "success": false
}

Internal server error, api will respond with 500 if something went wrong processing the request.

application/json

Schema

Example (from schema)

---

Schema

success boolean required

Default value: false

message string required

Default value: internal server error

error message

{
  "success": false,
  "message": "internal server error"
}

GET /v1/users/:user_id/get_user_translations

Request

Base URL

https://quranreflect.com

user_id — path required

client_auth_token — query required

access-token — header required

client — header required

expiry — header required

token-type — header required

uid — header required

curl / cURL

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

python / requests

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

go / native

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

nodejs / axios

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

ruby / Net::HTTP

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

csharp / RestSharp

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

php / cURL

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

java / OkHttp

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'

powershell / RestMethod

curl -L -X GET 'https://quranreflect.com/v1/users/:user_id/get_user_translations' \
-H 'Accept: application/json'