Personal info


API base url: https://api.vvvorg.com/v1/vorg-id/

Get userinfo

GET get/personal

scopes: VorgID::user

Get the userinfo.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <access_token>

Response

{
  "success": "ok",
  "data": {
    "id": 1,
    "name": "Peter Parker",
    "profile_img": "https://vvvorg.com/rrr/account.png",
    "birthday": "2009-10-09"
  },
}

Response body (If successful)

Parameter
Required?
Type
Description

success

yes

string

Always have the value ok.

data

yes

array

An array with information about the change.

data[id]

yes

string

User's id.

data[name]

yes

string

User's name.

data[profile_img]

yes

URI

Link to photo of the profile.

data[phone]

If there is an phone scope.

Phone Number

User's phone number.

data[phone_accepted]

If there is an phone scope.

Boolean

True if the phone number is verified.

data[email]

If there is an email scope.

string

User's email.

Edit email address

GET edit-email

scopes: VorgID::edit::email

Edit the email address.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <access_token>

Query Parameters

Parameter
Required?
Type
Description

email

yes

String

New email address.

sign

no

String

After the first request, a code will be sent to your email, and a hash token of the code will be returned to you. Have the user enter the code into their system within 15 minutes, combine it with the hash token returned to you using base64_encode("code:hash-token") and resend the request along with the sign.

Response

{
  "success": "ok",
  "data": {
    "new_email": "[email protected]",
    "hash_token": "46hj75jk57k5ek7e5j - ... - h64h6",
  },
}

Response body (If successful)

Parameter
Required?
Type
Description

success

yes

string

Always have the value ok.

data

yes

array

An array with information about the change.

data[new_email]

yes

string

New email address.

data[hash_token]

yes

string

Token to confirm OTP code.

Edit name

GET edit-name

scopes: VorgID::edit::personal

Edit the name.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <access_token>

Query Parameters

Parameter
Required?
Type
Description

name

yes

String

New name.

Response

{
  "success": "ok",
  "data": {
    "new_name": "Yaroslav",
  },
}

Response body (If successful)

Parameter
Required?
Type
Description

success

yes

string

Always have the value ok.

data

yes

array

An array with information about the change.

data[new_name]

yes

string

New name.

Edit profile phot

POST edit-photo

scopes: VorgID::edit::personal

Edit the photo profile.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <access_token>

Body

Parameter
Required?
Type
Description

file

yes

PNG file

New profile photo file in base64 format.

Response

{
  "success": "ok",
  "data": {
    "link": "https://cdn.vvvorg.com/___.png",
  },
}

Response body (If successful)

Parameter
Required?
Type
Description

success

yes

string

Always have the value ok.

data

yes

array

An array with information about the change.

data[link]

yes

URI

Link to profile photo on the server.

Last updated

Was this helpful?