MENU
      Get snapshot information

        Get snapshot information


        Article summary

        This is an API for querying snapshots in Live Station.

        Request

        GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/snapshot/{snapshotId}
        HTTP

        Request headers

        Header nameRequiredDescription
        x-ncp-apigw-timestampYESIt indicates the elapsed time in milliseconds since January 1, 1970 00:00:00 UTC. Request is considered invalid if the timestamp differs from the current time by more than 5 minutes
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYESAccess key ID value issued on NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESSpecify the request body content type as application/json
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Response

        Field nameTypeDescriptionRemarks
        channelIdStringID of the channel from which the snapshot was created
        channelStatusStringStatus of the channel from which the snapshot was createdCREATING, READY, PUBLISH, DELETED, BLOCK, FORCE_BLOCK, FORCE_DELETED
        snapshotObjectSnapshot object
        snapshot.snapshotIdIntegerSnapshot ID
        snapshot.snapshotUrlStringSnapshot playback URLSnapshot URLs are only valid for 1 hour from the time of creation
        snapshot.createdTimeIntegerSnapshot creation time
        snapshot.expireTimeIntegerSnapshot expiration time
        snapshot.durationIntegerSnapshot creation request timeUnit: minute

        Examples

        Response example

        HTTP/1.1 200 OK
        Server: nginx
        Date: Fri, 26 Jun 2022 09:53:32 GMT
        Content-Type: application/json;charset=utf-8
        Connection: keep-alive
        Access-Control-Allow-Origin: *
        x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
        
        {
          "content": {
            "channelId": "ls-20220623115623-fHnXy",
            "channelStatus": "PUBLISHING",
            "snapshot": {
              "snapshotId": 1047,
              "snapshotUrl": "https://mytest.edge.naverncp.com/dvr/snapshot/1655982268177/ls-nmssencg001/mtfpkgmjxmyecget2wjzthbeplp5vk9a7o6c/480p-16-9/1047-1655978668177.m3u8",
              "createdTime": 1655978668177,
              "expireTime": 1655982268177,
              "duration": 1
            }
          }
        }
        HTTP

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.