Melody User Service API

internal-metrics-controller

Endpointhttps://melody-gateway-main-0d30d7f.d2.zuplo.dev

Get follower metrics for multiple users

POST

https://melody-gateway-main-0d30d7f.d2.zuplo.dev

/users/internal/metrics/followers

Returns follower metrics (totalFollowers and newFollowers) with period comparison for the specified user IDs. This is an internal endpoint used by Catalog Service.

Get follower metrics for multiple users › Request Body

userIds

string[] · required

startDate

string · date · required

endDate

string · date · required

Get follower metrics for multiple users › Responses

Metrics retrieved successfully

object[]

POST/users/internal/metrics/followers

curl --request POST \
  --url https://melody-gateway-main-0d30d7f.d2.zuplo.dev/users/internal/metrics/followers \
  --header 'Content-Type: application/json' \
  --data '
{
  "userIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "startDate": "2024-08-25",
  "endDate": "2024-08-25"
}
'

shell

Example Request Body

{
  "userIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "startDate": "2024-08-25",
  "endDate": "2024-08-25"
}

json

Example Responses

{
  "metrics": [
    {
      "userId": "00000000-0000-0000-0000-000000000000",
      "totalFollowers": {
        "current": 82000000,
        "previous": 78500000,
        "absoluteChange": 3500000,
        "percentageChange": 4.46
      },
      "newFollowers": {
        "current": 82000000,
        "previous": 78500000,
        "absoluteChange": 3500000,
        "percentageChange": 4.46
      }
    }
  ]
}

json

application/json

admin-controller

Melody User Service API

internal-metrics-controller

Endpointhttps://melody-gateway-main-0d30d7f.d2.zuplo.dev

Get follower metrics for multiple users

POST

https://melody-gateway-main-0d30d7f.d2.zuplo.dev

/users/internal/metrics/followers

Returns follower metrics (totalFollowers and newFollowers) with period comparison for the specified user IDs. This is an internal endpoint used by Catalog Service.

Get follower metrics for multiple users › Request Body

userIds

string[] · required

startDate

string · date · required

endDate

string · date · required

Get follower metrics for multiple users › Responses

Metrics retrieved successfully

object[]

POST/users/internal/metrics/followers

curl --request POST \
  --url https://melody-gateway-main-0d30d7f.d2.zuplo.dev/users/internal/metrics/followers \
  --header 'Content-Type: application/json' \
  --data '
{
  "userIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "startDate": "2024-08-25",
  "endDate": "2024-08-25"
}
'

shell

Example Request Body

{
  "userIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "startDate": "2024-08-25",
  "endDate": "2024-08-25"
}

json

Example Responses

{
  "metrics": [
    {
      "userId": "00000000-0000-0000-0000-000000000000",
      "totalFollowers": {
        "current": 82000000,
        "previous": 78500000,
        "absoluteChange": 3500000,
        "percentageChange": 4.46
      },
      "newFollowers": {
        "current": 82000000,
        "previous": 78500000,
        "absoluteChange": 3500000,
        "percentageChange": 4.46
      }
    }
  ]
}

json

application/json

admin-controller