This endpoint provides your with all latest events that regard to your coubs.
Get notifications list
GET /api/v2/notifications
Request parameters:
- page (integer) — the number of the page containing results (by default is set to 1);
- per_page (integer) — the number of notifications per one page.
Request example:
GET /api/v2/notifications?page=1&per_page=10
Response parameters:
- page (integer) — the number of the required page;
- total_pages (integer) — the number of all pages;
- notifications (array) — the array of notification JSONs, each JSON consists of following fields:
- id (integer) — the notification identifier;
- kind (string) — the type of the notification, can contain one of the following values:
follow
, recoub
, like
;
- system_notification (boolean) — whether the notification was send by Coub services;
- entity_type (string) — the type of the object the notification relates to, can contain be either
channel
or coub
;
- read_at (UNIX-time) — the time when the notification was read;
- created_at (UNIX-time) — the time when the notification was created;
updated_at (UNIX-time) — the time when the notification was updated;
- important (boolean) — whether notification is marked as important;
- senders (array) — the array of channel small JSONs that contains data about the senders — channels that perform the action the notification relates to;
- recipient (JSON) — the channel small JSON that stores data about the user channel that receives the notification;
- object (JSON) — the coub big JSON that stores the data about the coub.
Set notifications as viewed
POST /api/v2/channels/notifications_viewed
Request parameters:
Respone parameters:
The JSON contains status
field.
Response example:
{
"status": "ok",
}