change announcement -> live-layer/public-chats

Change route for announcements to route for live layer and public chats,
as I got my logged information mixed up
This commit is contained in:
Zero 2020-01-22 20:29:53 -05:00
parent 099501966d
commit e005acf693
2 changed files with 97 additions and 99 deletions

View file

@ -1,94 +1,3 @@
<details>
<summary>GET /g/s/announcement/</summary>
GET the current announcement. This is actually just info about a bunch of communities and public chats
__query strings__
|name|description|required|
| - | - | - |
|start|paginated data index offset. Difference to|False|
|size|max number of items to get for paginated requests|False|
|language|Content language to be returned|False|
__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|
__responses__
- 200 - Info Retrieved
Info Retrieved
Announcement blogs and threads were retrieved
```JSON
{
"communityInfoMapping": {
"<ndcId>": "{...} <Community object>"
},
"paging": "{...} <Paging info>",
"playlistInThreadList": {
"<->": " <Info about videos playing in chat threads>",
"<UUIDv4 thread id>": {
"currentItemIndex": "14 <Playlist length>",
"currentItemStatus": "2 <Likely playlist current index>",
"items": [
"{...} <Youtube video object>"
]
}
},
"threadList": [
"{...} <Chat thread object>"
],
"userInfoInThread": {
"<->": " <Info about users in chat threads>",
"<UUIDv4 thread id>": {
"userProfileCount": 2,
"userProfileList": [
"{...} <User object>"
]
}
}
}
```
- 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 timestamp>",
"api:statuscode": "0 <Statuscode 0 is ok>",
"api:duration": "0.010s <Processing time>"
}
```
- 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 timestamp>",
"api:statuscode": "104 <Statuscode 104 represents a bad NDCDEVICEID header>",
"api:duration": "0.000s <Processing time>"
}
```
</details>
<details> <details>
<summary>GET /g/s/auid/</summary> <summary>GET /g/s/auid/</summary>
GET an auid for this device GET an auid for this device
@ -764,6 +673,96 @@ The NDCDEVICEID header was not included, or did not compute on amino servers
</details> </details>
<details>
<summary>GET /g/s/live-layer/public-chats/</summary>
GET the active public chats and information about who is in them.
__query strings__
|name|description|required|
| - | - | - |
|pageToken|page token for paginated requests|False|
|size|max number of items to get for paginated requests|False|
__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|
__responses__
- 200 - Chats Retrieved
Chats Retrieved
Chat info and users were retrieved
```JSON
{
"communityInfoMapping": {
"<ndcId>": "{...} <Community object>"
},
"paging": "{...} <Paging info>",
"playlistInThreadList": {
"<->": " <Info about videos playing in chat threads>",
"<UUIDv4 thread id>": {
"currentItemIndex": "14 <Playlist length>",
"currentItemStatus": "2 <Likely playlist current index>",
"items": [
"{...} <Youtube video object>"
]
}
},
"threadList": [
"{...} <Chat thread object>"
],
"userInfoInThread": {
"<->": " <Info about users in chat threads>",
"<UUIDv4 thread id>": {
"userProfileCount": 2,
"userProfileList": [
"{...} <User object>"
]
}
}
}
```
- 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 timestamp>",
"api:statuscode": "0 <Statuscode 0 is ok>",
"api:duration": "0.010s <Processing time>"
}
```
- 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 timestamp>",
"api:statuscode": "104 <Statuscode 104 represents a bad NDCDEVICEID header>",
"api:duration": "0.000s <Processing time>"
}
```
</details>
<details> <details>
<summary>GET /g/s/topic/:variant/feed/banner-ads/</summary> <summary>GET /g/s/topic/:variant/feed/banner-ads/</summary>
GET a piece of media for a topic. Usually seems to be used in homepage exploration GET a piece of media for a topic. Usually seems to be used in homepage exploration

View file

@ -343,7 +343,7 @@ vars:
], ],
"paging": "{...} <Paging info>" "paging": "{...} <Paging info>"
} }
announcement: live-layer:
GET: GET:
ok: ok:
lang: JSON lang: JSON
@ -531,15 +531,14 @@ routes:
title: Communities Retrieved title: Communities Retrieved
description: The communities for frontpage display were retrieved description: The communities for frontpage display were retrieved
body: $response.topic-communities.GET.ok body: $response.topic-communities.GET.ok
/g/s/announcement/: /g/s/live-layer/public-chats/:
GET: GET:
description: GET the current announcement. This is actually just info about a bunch of communities and public chats description: GET the active public chats and information about who is in them.
query strings: query strings:
- $query-strings.all.start - $query-strings.all.pageToken
- $query-strings.all.size - $query-strings.all.size
- $query-strings.all.language
responses: responses:
"200": "200":
title: Info Retrieved title: Chats Retrieved
description: Announcement blogs and threads were retrieved description: Chat info and users were retrieved
body: $response.announcement.GET.ok body: $response.live-layer.GET.ok