post_getUserProfilePhotos

v1.0.0

Use this method to get a list of profile pictures for a user. Returns a object.

Input

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Limits the number of photos to be retrieved. Values between 1-100 are accepted. Defaults to 100."
    },
    "offset": {
      "type": "integer",
      "description": "Sequential number of the first photo to be returned. By default, all photos are returned."
    },
    "user_id": {
      "type": "integer",
      "description": "Unique identifier of the target user"
    }
  }
}

Output

{
  "type": "object",
  "required": [
    "ok",
    "result"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "result": {
      "type": "object",
      "description": "This object represent a user's profile pictures.",
      "required": [
        "photos",
        "total_count"
      ],
      "properties": {
        "photos": {
          "type": "array",
          "description": "Requested profile pictures (in up to 4 sizes each)",
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "This object represents one size of a photo or a [file](https://core.telegram.org/bots/api/#document) / [sticker](https://core.telegram.org/bots/api/#sticker) thumbnail.",
              "required": [
                "file_id",
                "file_unique_id",
                "width",
                "height"
              ],
              "properties": {
                "file_id": {
                  "type": "string",
                  "description": "Identifier for this file, which can be used to download or reuse the file"
                },
                "file_size": {
                  "type": "integer",
                  "description": "*Optional*. File size"
                },
                "file_unique_id": {
                  "type": "string",
                  "description": "Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file."
                },
                "height": {
                  "type": "integer",
                  "description": "Photo height"
                },
                "width": {
                  "type": "integer",
                  "description": "Photo width"
                }
              }
            }
          }
        },
        "total_count": {
          "type": "integer",
          "description": "Total number of profile pictures the target user has"
        }
      }
    }
  }
}