plexgo/docs/sdks/sessions/README.md

Sessions

(Sessions)

Overview

API Calls that perform search operations with Plex Media Server Sessions

Available Operations

• GetSessions - Get Active Sessions
• GetSessionHistory - Get Session History
• GetTranscodeSessions - Get Transcode Sessions
• StopTranscodeSession - Stop a Transcode Session

GetSessions

This will retrieve the "Now Playing" Information of the PMS.

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo/models/components"
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("<value>"),
    )

    ctx := context.Background()
    res, err := s.Sessions.GetSessions(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
ctx	context.Context	✔️	The context to use for the request.

Response

*operations.GetSessionsResponse, error

Error Object	Status Code	Content Type
sdkerrors.GetSessionsResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/

GetSessionHistory

This will Retrieve a listing of all history views.

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo/models/components"
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("<value>"),
    )

    ctx := context.Background()
    res, err := s.Sessions.GetSessionHistory(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
ctx	context.Context	✔️	The context to use for the request.

Response

*operations.GetSessionHistoryResponse, error

Error Object	Status Code	Content Type
sdkerrors.GetSessionHistoryResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/

GetTranscodeSessions

Get Transcode Sessions

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo/models/components"
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("<value>"),
    )

    ctx := context.Background()
    res, err := s.Sessions.GetTranscodeSessions(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
ctx	context.Context	✔️	The context to use for the request.

Response

*operations.GetTranscodeSessionsResponse, error

Error Object	Status Code	Content Type
sdkerrors.GetTranscodeSessionsResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/

StopTranscodeSession

Stop a Transcode Session

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo/models/components"
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("<value>"),
    )


    var sessionKey string = "zz7llzqlx8w9vnrsbnwhbmep"

    ctx := context.Background()
    res, err := s.Sessions.StopTranscodeSession(ctx, sessionKey)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
ctx	context.Context	✔️	The context to use for the request.
sessionKey	string	✔️	the Key of the transcode session to stop	zz7llzqlx8w9vnrsbnwhbmep

Response

*operations.StopTranscodeSessionResponse, error

Error Object	Status Code	Content Type
sdkerrors.StopTranscodeSessionResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/