hyper

package module
v3.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 2, 2026 License: MIT Imports: 15 Imported by: 0

README

Hyper Solutions SDK - Go Library for Bot Protection Bypass (Akamai, Incapsula, Kasada, DataDome)

Go Version License GitHub Release GitHub Stars

A powerful Go SDK for bypassing modern bot protection systems including Akamai Bot Manager, Incapsula, Kasada, and DataDome. Generate valid cookies, solve anti-bot challenges, and automate protected endpoints with ease.

Perfect for web scraping, automation, and data collection from protected websites.

🔑 Getting API Access

Before using this SDK, you'll need an API key from Hyper Solutions:

  1. Visit hypersolutions.co to create your account
  2. Choose your plan:
    • 💳 Pay-as-you-go: Perfect for testing and small-scale usage
    • 📊 Subscription plans: Cost-effective for high-volume applications
  3. Get your API key from the dashboard
  4. Start bypassing bot protection with this SDK!

🚀 Quick Start

package main

import (
	"context"
	"fmt"

	"github.com/Hyper-Solutions/hyper-sdk-go/v3"
)

func main() {
	session := hyper.NewSession("your-api-key")

	// Generate Akamai sensor data
	sensorData, sensorContext, err := session.GenerateSensorData(context.Background(), &hyper.SensorInput{
		// Configure your sensor input
	})
	if err != nil {
		panic(err)
	}

	fmt.Printf("Generated sensor data: %s", sensorData)
	fmt.Printf("Sensor context: %s", sensorContext)
}

✨ Features

  • 🛡️ Akamai Bot Manager: Generate sensor data, handle pixel challenges, validate cookies
  • 🔒 Incapsula Protection: Generate Reese84 sensors and UTMVC cookies
  • ⚡ Kasada Bypass: Generate payload data (CT) and POW tokens (CD)
  • 🎯 DataDome Solutions: Solve tags, slider captchas and interstitial challenges
  • 🔧 Easy Integration: Simple Go API with comprehensive documentation
  • ⚙️ Flexible Configuration: Custom HTTP clients and JWT key support

📦 Installation

Install the Hyper Solutions SDK for Go using:

go get github.com/Hyper-Solutions/hyper-sdk-go/v3

📋 Table of Contents

🔧 Basic Usage

Creating a Session

Initialize the SDK with your API key to start bypassing bot protection:

// Basic session
session := hyper.NewSession("your-api-key")

// Advanced session with custom configuration
session := hyper.NewSession("your-api-key").
    WithJwtKey("your-jwt-key").
    WithClient(customHTTPClient)

🛡️ Akamai Bot Manager

Bypass Akamai Bot Manager protection with sensor data generation, cookie validation, and challenge solving.

Generating Sensor Data

Generate sensor data for valid Akamai cookies and bot detection bypass:

sensorData, sensorContext, err := session.GenerateSensorData(ctx, &hyper.SensorInput{
    // Configure sensor parameters
})
if err != nil {
    // Handle error
}
Parsing Script Path

Extract Akamai Bot Manager script paths from HTML for reverse engineering:

scriptPath, err := akamai.ParseScriptPath(reader)
if err != nil {
    // Handle error
}
Handling Sec-Cpt Challenges

Solve sec-cpt challenges with built-in parsing and payload generation:

  • ParseSecCptChallenge: Parse sec-cpt challenges from HTML
  • ParseSecCptChallengeFromJson: Parse from JSON responses
  • GenerateSecCptPayload: Generate challenge response payloads
  • Sleep: Handle challenge timing requirements
  • SleepWithContext: Context-aware challenge delays

Validate Akamai _abck cookies and session states:

  • IsCookieValid: Check cookie validity for request counts
  • IsCookieInvalidated: Determine if more sensors are needed
Pixel Challenge Solving

Handle Akamai pixel challenges for advanced bot detection bypass:

pixelData, err := session.GeneratePixelData(ctx, &hyper.PixelInput{
    // Pixel challenge parameters
})
if err != nil {
    // Handle error
}

Pixel parsing functions:

  • ParsePixelHtmlVar: Extract pixel variables from HTML
  • ParsePixelScriptURL: Get pixel script and POST URLs
  • ParsePixelScriptVar: Parse dynamic pixel values

🔒 Incapsula Protection

Bypass Incapsula bot detection with Reese84 sensors and UTMVC cookie generation.

Generating Reese84 Sensors

Create Reese84 sensor data for Incapsula bypass:

sensorData, err := session.GenerateReese84Sensor(ctx, site, userAgent)
if err != nil {
    // Handle error
}

Generate UTMVC cookies for Incapsula protection bypass:

utmvcCookie, err := session.GenerateUtmvcCookie(ctx, &hyper.UtmvcInput{
    Script: "incapsula-script-content",
    SessionIds: []string{"session-id-1", "session-id-2"},
    UserAgent: "Mozilla/5.0 (compatible bot)"
})
if err != nil {
    // Handle error
}
Script Path Parsing

Parse UTMVC script paths for Incapsula integration:

scriptPath, err := incapsula.ParseUtmvcScriptPath(scriptReader)
if err != nil {
    // Handle error
}

// Generate submit path
submitPath := incapsula.GetUtmvcSubmitPath()

⚡ Kasada Bypass

Defeat Kasada Bot Manager with payload generation and POW solving.

Generating Payload Data (CT)

Create x-kpsdk-ct tokens for Kasada bypass:

payload, headers, err := session.GenerateKasadaPayload(ctx, &hyper.KasadaPayloadInput{
    // Kasada payload configuration
})
if err != nil {
    // Handle error
}
Generating POW Data (CD)

Solve Kasada Proof-of-Work challenges for x-kpsdk-cd tokens:

powPayload, err := session.GenerateKasadaPow(ctx, &hyper.KasadaPowInput{
    // POW challenge parameters
})
if err != nil {
    // Handle error
}
Script Path Extraction

Extract Kasada script paths from blocked pages (HTTP 429):

scriptPath, err := kasada.ParseScriptPath(reader)
if err != nil {
    // Handle error
}
// Returns: /ips.js?timestamp=...

🎯 DataDome Solutions

Solve DataDome captchas including slider challenges and interstitial pages.

Interstitial Challenge Solving

Bypass DataDome interstitial pages:

payload, headers, err := session.GenerateDataDomeInterstitial(ctx, &hyper.DataDomeInterstitialInput{
    // Interstitial parameters
})
if err != nil {
    // Handle error
}
// POST payload to https://geo.captcha-delivery.com/interstitial/
Slider Captcha Solving

Solve DataDome slider captchas automatically:

checkUrl, headers, err := session.GenerateDataDomeSlider(ctx, &hyper.DataDomeSliderInput{
    // Slider challenge parameters
})
if err != nil {
    // Handle error
}
// GET request to checkUrl

Extract DataDome device check URLs:

// Interstitial device links
deviceLink, err := datadome.ParseInterstitialDeviceCheckLink(reader, datadomeCookie, referer)
if err != nil {
    // Handle error
}

// Slider device links  
deviceLink, err := datadome.ParseSliderDeviceCheckLink(reader, datadomeCookie, referer)
if err != nil {
    // Handle error
}
Challenge Script Parsing

DataDome serves some challenge pages with the bundle inlined in the HTML and others with it in its own file, switching between the two per request. When a page uses its own file, fetch it and pass it as Script:

// After GET-ing the deviceLink and reading the body into html
var script string
if scriptURL, ok := datadome.ParseChallengeScriptURL(html); ok {
    // GET scriptURL with the same client, proxy and headers, then read the body
    script = scriptBody
}

payload, headers, err := session.GenerateDataDomeInterstitial(ctx, &hyper.DataDomeInterstitialInput{
    // ... other parameters
    Html:   html,
    Script: script, // empty when the page inlines the bundle
})

The same applies to DataDomeSliderInput. Script is optional and leaving it empty keeps working, but the payload is then built against a pinned script version instead of the one the page actually served.

Getting Help

📄 License

This SDK is licensed under the MIT License.

Keywords: Go SDK, Golang, bot protection bypass, web scraping, Akamai bypass, Incapsula bypass, Kasada bypass, DataDome bypass, anti-bot, captcha solver, automation, reverse engineering, bot detection, web automation

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type BotIDHeaderInput 

type BotIDHeaderInput struct {
	Script         string `json:"script"`
	UserAgent      string `json:"userAgent"`
	IP             string `json:"ip"`
	AcceptLanguage string `json:"acceptLanguage"`
}

func (BotIDHeaderInput) MarshalEasyJSON 

func (v BotIDHeaderInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (BotIDHeaderInput) MarshalJSON 

func (v BotIDHeaderInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*BotIDHeaderInput) UnmarshalEasyJSON 

func (v *BotIDHeaderInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*BotIDHeaderInput) UnmarshalJSON 

func (v *BotIDHeaderInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type CompressionType 

type CompressionType string

CompressionType represents the compression algorithm to use 

const (
	CompressionZstd CompressionType = "zstd"
	CompressionGzip CompressionType = "gzip"
)

type DataDomeInterstitialInput 

type DataDomeInterstitialInput struct {
	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent string `json:"userAgent"`

	// DeviceLink is the URL that contains the script and starts like this:
	// https://geo.captcha-delivery.com/captcha/?initialCid
	DeviceLink string `json:"deviceLink"`

	// Html is the response body of the GET request to the DeviceLink
	Html string `json:"html"`

	// Script is the DataDome challenge bundle. It is only needed when the
	// challenge page loads the bundle with a <script defer src="..."> tag
	// instead of inlining it, which DataDome does per request. Use
	// datadome.ParseChallengeScriptURL on the Html to find out, then GET that
	// URL with the same client and pass the response body here.
	//
	// Leave it empty when the page inlines the bundle.
	Script string `json:"script"`

	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
}

func (DataDomeInterstitialInput) MarshalEasyJSON 

func (v DataDomeInterstitialInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (DataDomeInterstitialInput) MarshalJSON 

func (v DataDomeInterstitialInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*DataDomeInterstitialInput) UnmarshalEasyJSON 

func (v *DataDomeInterstitialInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*DataDomeInterstitialInput) UnmarshalJSON 

func (v *DataDomeInterstitialInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type DataDomeSliderInput 

type DataDomeSliderInput struct {
	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent string `json:"userAgent"`

	// DeviceLink is the URL that contains the script and starts like this:
	// https://geo.captcha-delivery.com/captcha/?initialCid
	DeviceLink string `json:"deviceLink"`

	// Html is the response body of the GET request to the DeviceLink
	Html string `json:"html"`

	// Puzzle is the captcha puzzle image bytes, base64 encoded.
	// The URL that returns the puzzle looks like this:
	// https://dd.prod.captcha-delivery.com/image/2024-xx-xx/hash.jpg
	Puzzle string `json:"puzzle"`

	// Piece is the captcha puzzle piece image bytes, base64 encoded.
	// The URL that returns the puzzle looks like this:
	// https://dd.prod.captcha-delivery.com/image/2024-xx-xx/hash.frag.png
	Piece string `json:"piece"`

	ParentUrl string `json:"parentUrl"`

	// Script is the DataDome challenge bundle. It is only needed when the
	// challenge page loads the bundle with a <script defer src="..."> tag
	// instead of inlining it, which DataDome does per request. Use
	// datadome.ParseChallengeScriptURL on the Html to find out, then GET that
	// URL with the same client and pass the response body here.
	//
	// Leave it empty when the page inlines the bundle.
	Script string `json:"script"`

	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
}

func (DataDomeSliderInput) MarshalEasyJSON 

func (v DataDomeSliderInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (DataDomeSliderInput) MarshalJSON 

func (v DataDomeSliderInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*DataDomeSliderInput) UnmarshalEasyJSON 

func (v *DataDomeSliderInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*DataDomeSliderInput) UnmarshalJSON 

func (v *DataDomeSliderInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type DataDomeTagsInput 

type DataDomeTagsInput struct {
	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent string `json:"userAgent"`

	Cid     string `json:"cid"`
	Ddk     string `json:"ddk"`
	Referer string `json:"referer"`
	Type    string `json:"type"`

	Version        string `json:"version"`
	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
}

func (DataDomeTagsInput) MarshalEasyJSON 

func (v DataDomeTagsInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (DataDomeTagsInput) MarshalJSON 

func (v DataDomeTagsInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*DataDomeTagsInput) UnmarshalEasyJSON 

func (v *DataDomeTagsInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*DataDomeTagsInput) UnmarshalJSON 

func (v *DataDomeTagsInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type DynamicInput 

type DynamicInput struct {
	// Script is the akamai script's contents.
	Script string `json:"script"`
}

func (DynamicInput) MarshalEasyJSON 

func (v DynamicInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (DynamicInput) MarshalJSON 

func (v DynamicInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*DynamicInput) UnmarshalEasyJSON 

func (v *DynamicInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*DynamicInput) UnmarshalJSON 

func (v *DynamicInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Headers 

type Headers struct {
	DeviceMemory    string `json:"sec-ch-device-memory"`
	Mobile          string `json:"sec-ch-ua-mobile"`
	Arch            string `json:"sec-ch-ua-arch"`
	Platform        string `json:"sec-ch-ua-platform"`
	Model           string `json:"sec-ch-ua-model"`
	FullVersionList string `json:"sec-ch-ua-full-version-list"`

	Bitness              string `json:"sec-ch-ua-bitness"`
	PlatformVersion      string `json:"sec-ch-ua-platform-version"`
	FullVersion          string `json:"sec-ch-ua-full-version"`
	Wow64                string `json:"sec-ch-ua-wow64"`
	FormFactors          string `json:"sec-ch-ua-form-factors"`
	DPR                  string `json:"sec-ch-dpr"`
	ViewportWidth        string `json:"sec-ch-viewport-width"`
	ViewportHeight       string `json:"sec-ch-viewport-height"`
	PrefersColorScheme   string `json:"sec-ch-prefers-color-scheme"`
	PrefersReducedMotion string `json:"sec-ch-prefers-reduced-motion"`
}

func (Headers) MarshalEasyJSON 

func (v Headers) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Headers) MarshalJSON 

func (v Headers) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Headers) UnmarshalEasyJSON 

func (v *Headers) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Headers) UnmarshalJSON 

func (v *Headers) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type KasadaHeaders 

type KasadaHeaders struct {
	XKpsdkCt string `json:"x-kpsdk-ct"`
	XKpsdkDt string `json:"x-kpsdk-dt"`
	XKpsdkV  string `json:"x-kpsdk-v"`
	XKpsdkR  string `json:"x-kpsdk-r"`
	XKpsdkDv string `json:"x-kpsdk-dv"`
	XKpsdkH  string `json:"x-kpsdk-h"`
	XKpsdkFc string `json:"x-kpsdk-fc"`
	XKpsdkIm string `json:"x-kpsdk-im"`
}

func (KasadaHeaders) MarshalEasyJSON 

func (v KasadaHeaders) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (KasadaHeaders) MarshalJSON 

func (v KasadaHeaders) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*KasadaHeaders) UnmarshalEasyJSON 

func (v *KasadaHeaders) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*KasadaHeaders) UnmarshalJSON 

func (v *KasadaHeaders) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type KasadaPayloadInput 

type KasadaPayloadInput struct {
	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent string `json:"userAgent"`

	// IpsLink is the ips.js script link, parsed from the block page (429 status code)
	IpsLink string `json:"ipsLink"`

	// Script is the ips.js script retrieved using the IpsLink url
	Script string `json:"script"`

	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip,omitempty"`
}

func (KasadaPayloadInput) MarshalEasyJSON 

func (v KasadaPayloadInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (KasadaPayloadInput) MarshalJSON 

func (v KasadaPayloadInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*KasadaPayloadInput) UnmarshalEasyJSON 

func (v *KasadaPayloadInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*KasadaPayloadInput) UnmarshalJSON 

func (v *KasadaPayloadInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type KasadaPowInput 

type KasadaPowInput struct {
	// St is the x-kpsdk-st value returned by the /tl POST request
	St     int    `json:"st"`
	Ct     string `json:"ct"`
	Fc     string `json:"fc"`
	Domain string `json:"domain"`
	Script string `json:"script"`
	// WorkTime can be used to pre-generate POW strings
	WorkTime *int `json:"workTime,omitempty"`
}

func (KasadaPowInput) MarshalEasyJSON 

func (v KasadaPowInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (KasadaPowInput) MarshalJSON 

func (v KasadaPowInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*KasadaPowInput) UnmarshalEasyJSON 

func (v *KasadaPowInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*KasadaPowInput) UnmarshalJSON 

func (v *KasadaPowInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type PixelInput 

type PixelInput struct {
	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent      string `json:"userAgent"`
	HTMLVar        string `json:"htmlVar"`
	ScriptVar      string `json:"scriptVar"`
	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
}

func (PixelInput) MarshalEasyJSON 

func (v PixelInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (PixelInput) MarshalJSON 

func (v PixelInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*PixelInput) UnmarshalEasyJSON 

func (v *PixelInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*PixelInput) UnmarshalJSON 

func (v *PixelInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type ReeseInput 

type ReeseInput struct {
	UserAgent      string `json:"userAgent"`
	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
	ScriptUrl      string `json:"scriptUrl"`
	PageUrl        string `json:"pageUrl"`
	Pow            string `json:"pow"`
	Script         string `json:"script"`
}

func (ReeseInput) MarshalEasyJSON 

func (v ReeseInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (ReeseInput) MarshalJSON 

func (v ReeseInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*ReeseInput) UnmarshalEasyJSON 

func (v *ReeseInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*ReeseInput) UnmarshalJSON 

func (v *ReeseInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type SbsdInput 

type SbsdInput struct {
	Index int `json:"index"`
	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent string `json:"userAgent"`
	Uuid      string `json:"uuid"`
	PageUrl   string `json:"pageUrl"`
	OCookie   string `json:"o"`

	// Script is mutually exclusive with [SbsdInput.Context], the first sbsd request should include the script field.
	// 	Subsequent requests should only include the Context.
	Script string `json:"script"`

	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
	Context        string `json:"context"`
}

func (SbsdInput) MarshalEasyJSON 

func (v SbsdInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (SbsdInput) MarshalJSON 

func (v SbsdInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*SbsdInput) UnmarshalEasyJSON 

func (v *SbsdInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*SbsdInput) UnmarshalJSON 

func (v *SbsdInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type SensorInput 

type SensorInput struct {
	// Abck is the _abck cookie retrieved from your cookiejar.
	// Make sure you always retrieve it fresh from the cookiejar as it gets updated while making requests.
	Abck string `json:"abck"`

	// Bmsz is the bm_sz cookie retrieved from your cookiejar, make sure you always retrieve it fresh from the cookiejar.
	Bmsz string `json:"bmsz"`

	// Version is the akamai version, this will usually be "2"
	Version string `json:"version"`

	// PageUrl is the page url that loaded the akamai script, it is the same URL as the referer header on the sensor posts
	PageUrl string `json:"pageUrl"`

	// UserAgent must be a Chrome Windows User-Agent.
	UserAgent string `json:"userAgent"`

	// Script is mutually exclusive with [SensorInput.Context], the first sensor request should include the script field.
	// 	Subsequent request should only include the Context.
	Script string `json:"script"`

	// ScriptUrl is the full URL where you are posting sensor data to
	ScriptUrl string `json:"scriptUrl"`

	AcceptLanguage string `json:"acceptLanguage"`
	IP             string `json:"ip"`
	Context        string `json:"context"`
}

func (SensorInput) MarshalEasyJSON 

func (v SensorInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (SensorInput) MarshalJSON 

func (v SensorInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*SensorInput) UnmarshalEasyJSON 

func (v *SensorInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*SensorInput) UnmarshalJSON 

func (v *SensorInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Session 

type Session struct {
	ApiKey      string
	JwtKey      []byte
	AppKey      string
	AppSecret   []byte
	Client      *http.Client
	Compression CompressionType
}

func NewSession 

func NewSession(apiKey string) *Session

NewSession creates a new Session that can be used to make requests to the Hyper Solutions API.

func (*Session) GenerateBotIDHeader 

func (s *Session) GenerateBotIDHeader(ctx context.Context, input *BotIDHeaderInput) (string, error)

GenerateBotIDHeader returns the x-is-human header value

func (*Session) GenerateDataDomeInterstitial 

func (s *Session) GenerateDataDomeInterstitial(ctx context.Context, input *DataDomeInterstitialInput) (string, *Headers, error)

GenerateDataDomeInterstitial returns the form data string that is used in the POST request to receive a solved datadome cookie, and the extra sec-ch-* headers used on consequent requests.

func (*Session) GenerateDataDomeSlider 

func (s *Session) GenerateDataDomeSlider(ctx context.Context, input *DataDomeSliderInput) (string, *Headers, error)

GenerateDataDomeSlider returns the URL that will return a solved datadome cookie when blocked by captcha, and the extra sec-ch-* headers used on consequent requests.

func (*Session) GenerateDataDomeTags 

func (s *Session) GenerateDataDomeTags(ctx context.Context, input *DataDomeTagsInput) (string, error)

GenerateDataDomeTags returns the tags data string that is used in the POST request to receive a solved datadome cookie.

func (*Session) GenerateKasadaPayload 

func (s *Session) GenerateKasadaPayload(ctx context.Context, input *KasadaPayloadInput) ([]byte, *KasadaHeaders, error)

GenerateKasadaPayload returns the payload to POST to /tl in bytes, and the generated headers

func (*Session) GenerateKasadaPow 

func (s *Session) GenerateKasadaPow(ctx context.Context, input *KasadaPowInput) (string, error)

GenerateKasadaPow returns the x-kpsdk-cd value

func (*Session) GeneratePixelData 

func (s *Session) GeneratePixelData(ctx context.Context, input *PixelInput) (string, error)

GeneratePixelData returns the pixel data using the Hyper Solutions API.

func (*Session) GenerateReese84Sensor 

func (s *Session) GenerateReese84Sensor(ctx context.Context, input *ReeseInput) (string, error)

GenerateReese84Sensor returns the sensor data required to generate valid reese84 cookies using the Hyper Solutions API.

func (*Session) GenerateSbsdData 

func (s *Session) GenerateSbsdData(ctx context.Context, input *SbsdInput) (string, string, error)

GenerateSbsdData returns the sbsd payload and context using the Hyper Solutions API.

func (*Session) GenerateSensorData 

func (s *Session) GenerateSensorData(ctx context.Context, input *SensorInput) (string, string, error)

GenerateSensorData returns the sensor data required to generate valid akamai cookies using the Hyper Solutions API.

func (*Session) GenerateUtmvcCookie 

func (s *Session) GenerateUtmvcCookie(ctx context.Context, input *UtmvcInput) (string, string, error)

GenerateUtmvcCookie returns the utmvc cookie using the Hyper Solutions API.

func (*Session) WithClient 

func (s *Session) WithClient(client *http.Client) *Session

WithClient sets a new client that will be used to make requests to the Hyper Solutions API.

func (*Session) WithCompression 

func (s *Session) WithCompression(compression CompressionType) *Session

WithCompression sets the compression type for requests.

func (*Session) WithJwtKey 

func (s *Session) WithJwtKey(jwt string) *Session

WithJwtKey adds the JWT Key to the session. If not empty, a signature will be added to each request.

func (*Session) WithOrganization 

func (s *Session) WithOrganization(key, secret string) *Session

WithOrganization adds the organization to the session.

type UtmvcInput 

type UtmvcInput struct {
	UserAgent string `json:"userAgent"`

	// SessionIds The value of each cookie that has a name that starts with incap_ses_
	SessionIds []string `json:"sessionIds"`

	// Script is the UTMVC script contents
	Script string `json:"script"`
}

func (UtmvcInput) MarshalEasyJSON 

func (v UtmvcInput) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (UtmvcInput) MarshalJSON 

func (v UtmvcInput) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*UtmvcInput) UnmarshalEasyJSON 

func (v *UtmvcInput) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*UtmvcInput) UnmarshalJSON 

func (v *UtmvcInput) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

Source Files

View all Source files

Directories

Path Synopsis
internal

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.