New user?
REGISTER NOW!

Returning user?
SIGN IN!


Forgot your password?


It's completely free!

OR

ANDROID DEV
Register here

Forgot your password?


Loading...
OR

You're one step closer to becoming a Aptoider!

We will send you a confirmation email to

In the meantime please continue to the final registration step.


Continue to final step Ups... wrong email...

Need to contact us?

Please insert an email address Password must:<br>- have 8 characters minimum<br>- have one letter<br>- have one number OR one special character (!@#$%*) This url is invalid, please enter an valid one. Use only letters, numbers and/or dashes. No spaces please! Please insert a name Business Name should be smaller than 40 characters. Please insert an address. Please insert an company name. Please insert an valid country. Please insert a valid phone number. Please insert a valid phone number. Please insert an city. Please insert an zip/postal code. Please insert an tax ID / VAT. You must agree with terms of use. You must select one option RETRY JOIN NOW https://www.aptoide.com/phpajax/onboarding.php
This website uses cookies to improve service quality. By browsing this website, you are consenting the use of cookies.
I understand Learn more
OK

Web Services Documentation

Validating user login credentials

This endpoint is deprecated. See: https://www.aptoide.com/webservices/docs/3/oauth2Authentication

URLS:

POST

GET

Supported Formats:

JSON XML

Supported Methods:

GET POST

Description:

Validates user login credentials by returning a token (to use in other webservices).

Arguments:

user User id (email)
passhash SHA1 hash of the user password
repo Repository name
mode Return mode/format ('xml' or 'json')

Response:

status Request result status (OK or FAIL)
token The user dev token (not existent when status!="OK")
repo "repo" value or default user repository/store otherwise
ravatar_hd HD Avatar URL for returned "repo" repository/store
avatar Avatar URL for returned "repo" repository/store
username The user username
errors Errors log from the request (not existent when status="OK")

Error Codes:

Name Description
AUTH-1 Invalid login credentials!
AUTH-2 Invalid credentials!
AUTH-3 Your account was cancelled. For any questions, contact Aptoide Support team.
AUTH-100 Could not login with Google. Please check your Google account (you may need to validate your email address).
AUTH-101 Could not login with Google. Please try again.
AUTH-102 Could not login with Facebook. Please check your Facebook account (you may need to validate your email address).
AUTH-103 Could not login with Facebook. Please try again.
IARG-200 Invalid oauthToken!
IARG-201 Invalid authMode!
MARG-200 Missing authentication parameter: oauthToken
MARG-201 Missing authentication parameter(s): user and/or password
REPO-1 The provided store does not exist.
REPO-2 The provided store was cancelled.
REPO-3 The provided store does not belong to this user.
SYS-1 An unknown error occurred, please try again.
WOP-1 Your account has a store already. You cannot create another one under the same account.
WOP-2 Invalid name given for your store. The name of a store can only have alphanumeric characters (A to Z and 0 to 9) or hyphens (-), and it cannot start nor end with a hyphen.
WOP-3 A store already exists with the same name. Please give another name for your store.
WOP-4 The store could not be created. Please try again.
WOP-5 You need to give a name for your store.

Using the Web Service (examples):

Sample Response - XML:

Sample success

<response>
   <status>OK</status>
   <token>57f31fbd02d19ebf59b282aca416ff80ff6a74964e2953db5f674</token>
   <repo>my-store</repo>
   <queueName>web_install_e8c363376ecd51112f9df21ea39928f1b80257b9</queueName>
   <ravatar_hd>http://www.aptoide.com/imgs/8/c/a/8ca2e288ae1f63f31accafdcb9d0728c_ravatar.png</ravatar_hd>
   <avatar>http://www.aptoide.com/imgs/6/d/4/6d496eb7b01864899cd065381d89cb75_avatar_50x50.png</avatar>
   <username>Mister Aptoide</username>
</response>

Sample Response - JSON:

Sample success

{
   "status":"OK",
   "token": "57f31fbd02d19ebf59b282aca416ff80ff6a74964e2953db5f674",
   "repo": "my-store",
   "queueName":"web_install_e8c363376ecd51112f9df21ea39928f1b80257b9"
   "ravatar_hd":"http://www.aptoide.com/imgs/8/c/a/8ca2e288ae1f63f31accafdcb9d0728c_ravatar.png",
   "avatar":"http://www.aptoide.com/imgs/6/d/4/6d496eb7b01864899cd065381d89cb75_avatar_50x50.png",
   "username":"Mister Aptoide"
}