diff --git a/amino/no-auth.md b/amino/docs.md similarity index 85% rename from amino/no-auth.md rename to amino/docs.md index fead859..883ee9f 100644 --- a/amino/no-auth.md +++ b/amino/docs.md @@ -190,6 +190,132 @@ The NDCDEVICEID header was not included, or did not compute on amino servers +
+POST /g/s/auth/login/ +Log in with credentials + +__headers__ + +|name|description|required| +| - | - | - | +|NDCDEVICEID|The device id generated by the app. See|True| +|NDC-MSG-SIG|Message signature (?) generated by the app|False| +|SMDEVICEID|I don't know, seems to be a non-string hex number|False| +|AUID|The auid (UUIDv4) generated on amino servers for this client, retrieved with GET /g/s/auid|False| + +```JSON +{ + "email": "... ", + "v": "2 ", + "secret": "... \"", + "deviceID": "... ", + "clientType": "100 ", + "action": "normal ", + "timestamp": "1579754764781 ": " ", + "activation": "1 ", + "phoneNumber": "null ", + "phoneNumberActivation": "0 ", + "emailActivation": "1 ", + "username": "null ", + "uid": "... ", + "aminoIdEditable": "true ", + "membership": "null ", + "aminoId": "BooruBot ", + "mediaList": "null ", + "icon": "... ", + "nickname": "BooruBot ", + "role": "0 ", + "securityLevel": "3 ", + "status": "0 ", + "dateOfBirth": "null ", + "address": "null ", + "latitude": "null ", + "longitude": "null ", + "facebookID": "null ", + "googleID": "null ", + "twitterID": "null ", + "gender": "null ", + "createdTime": "2019-05-16T03:47:29Z ", + "modifiedTime": "2019-08-15T06:39:15Z ", + "advancedSettings": "{...} ", + "extensions": { + "adsEnabled": "true ", + "adsFlags": "11 ", + "adsLevel": "1 ", + "contentLanguage": "en ", + "deviceInfo": { + "lastClientType": "100 " + } + } + }, + "auid": "... ", + "secret": "... ", + "sid": "... ", + "userProfile": "{...} " +} +``` + +- 200:0 - api:ok +api:ok + +The request was successful. This is not a separate response, but included in every 200 response's json + +```JSON +{ + "api:message": "OK", + "api:timestamp": "2020-01-22T23:49:13Z ", + "api:statuscode": "0 ", + "api:duration": "0.010s " +} +``` + +- 400:104 - Missing NDCDEVICEID +Missing NDCDEVICEID + +The NDCDEVICEID header was not included, or did not compute on amino servers + +```JSON +{ + "api:message": "Invalid Request. Please update to the latest version. If the problem continues, please contact us.", + "api:timestamp": "2020-01-22T22:11:28Z ", + "api:statuscode": "104 ", + "api:duration": "0.000s " +} +``` + +- 400:200 - Login Unsuccessful +Login Unsuccessful + +The supplied credentials were not correct + +```JSON +{ + "api:message": "Account or password is incorrect! If you forget your password, please reset it.", + "api:timestamp": "2020-01-23T04:44:36Z ", + "api:statuscode": "200 ", + "api:duration": "0.016s " +} +``` + + +
+ +
POST /g/s/client-config/ POST device information for configuration. Likely related to analytics / telemetry diff --git a/amino/no-auth.yml b/amino/docs.yml similarity index 80% rename from amino/no-auth.yml rename to amino/docs.yml index 5ce0ecc..2d2d9ae 100644 --- a/amino/no-auth.yml +++ b/amino/docs.yml @@ -98,6 +98,20 @@ vars: "device": "d2usc ", "timestamp": "1579580222209 " } + login: + POST: + lang: JSON + content: + { + "email": "... ", + "v": "2 ", + "secret": "... \"", + "deviceID": "... ", + "clientType": "100 ", + "action": "normal ", + "timestamp": "1579754764781 " ] } - + login: + POST: + ok: + lang: JSON + content: + { + "account": { + "<->": " ", + "activation": "1 ", + "phoneNumber": "null ", + "phoneNumberActivation": "0 ", + "emailActivation": "1 ", + "username": "null ", + "uid": "... ", + "aminoIdEditable": "true ", + "membership": "null ", + "aminoId": "BooruBot ", + "mediaList": "null ", + "icon": "... ", + "nickname": "BooruBot ", + "role": "0 ", + "securityLevel": "3 ", + "status": "0 ", + "dateOfBirth": "null ", + "address": "null ", + "latitude": "null ", + "longitude": "null ", + "facebookID": "null ", + "googleID": "null ", + "twitterID": "null ", + "gender": "null ", + "createdTime": "2019-05-16T03:47:29Z ", + "modifiedTime": "2019-08-15T06:39:15Z ", + "advancedSettings": "{...} ", + "extensions": { + "adsEnabled": "true ", + "adsFlags": "11 ", + "adsLevel": "1 ", + "contentLanguage": "en ", + "deviceInfo": { + "lastClientType": "100 " + } + }, + }, + "auid": "... ", + "secret": "... ", + "sid": "... ", + "userProfile": "{...} " + } + incorrect-info: + lang: JSON + content: + { + "api:message": "Account or password is incorrect! If you forget your password, please reset it.", + "api:timestamp": "2020-01-23T04:44:36Z ", + "api:statuscode": "200 ", + "api:duration": "0.016s " + } api_codes: api:104: lang: JSON @@ -408,6 +480,7 @@ vars: } routes: + # Does not require auth /g/s/device/: POST: description: POST a device configuration @@ -565,3 +638,17 @@ routes: title: Announcements Retrieved description: Current announcement blogs were retrieved body: $response.announcement.GET.ok + # On login + /g/s/auth/login/: + POST: + description: Log in with credentials + body: $request.login.POST + responses: + "200": + title: Login Successful + description: The login was successful and account information was sent + body: $response.login.POST.ok + 400:200: + title: Login Unsuccessful + description: The supplied credentials were not correct + body: $response.login.POST.incorrect-info