Funpay

Go library for Funpay.

[!important] This library is currently developing! But may used to handle user and lots. Use [Funpay.Request] and [Funpay.RequestHTML] to make your own modules.

Installation

go get github.com/kostromin59/funpay

Example usage

Account handling

func main() {
	goldenKey := "gk"
	userAgent := "ua"

	fp := funpay.New(goldenKey, userAgent)

	// Update account info, csrf token and cookies
	// Should be called every 40-60 minutes
	if err := fp.Update(context.TODO()); err != nil {
		log.Println(err.Error())
		return
	}

	log.Printf("account id: %d", fp.UserID())
	log.Printf("username: %q", fp.Username())
	log.Printf("balance: %d", fp.Balance())
	log.Printf("locale: %q", fp.Locale())
}

Lots

func main() {
	fp := funpay.New("golden key", "user agent")
	if err := fp.Update(context.TODO()); err != nil {
		panic(err)
	}

	fpLots := lots.New(fp)

	// Load lots for current user
	if err := fpLots.Update(context.TODO()); err != nil {
		log.Println(err.Error())
		return
	}

	// Returns [nodeID]: []string{offerIDs...}
	lotsList := fpLots.List()
	log.Printf("count of nodes: %d", len(lotsList))

	// Returns all fields with values to update lot (offer)
	fields, err := fpLots.FieldsByOfferID(context.TODO(), "", "some_id")
	if err != nil {
		log.Println(err.Error())
		return
	}

	// Change field
	fields["price"] = lots.Field{
		Value: "1500",
	}

	// Save lot (offer)
	if err := fpLots.Save(context.Background(), fields); err != nil {
		log.Println(err.Error())
		return
	}

	// Returns all fields of lot by node (category) without values
	// 2852 - Accounts Call of Duty: Black Ops 6
	fields, err = fpLots.FieldsByNodeID(context.Background(), "2852")
	if err != nil {
		log.Println(err.Error())
		return
	}

	offerID := fields["offer_id"]
	log.Println(offerID.Value == "0") // true
}

To-Do

This list may grow while developing.

• [X] Other
  • [X] Use single entrypoint as base (funpay.New)
  • [X] Dedicated lots module
• [X] Requests
  • [X] Request with account data
  • [X] Proxy support
  • [X] Locale support (setlocale query param and path param for en)
  • [X] Auto load locale
• [X] Account
  • [X] Info
    • [X] Username
    • [X] Balance (from badge)
  • [X] Updating cookies
  • [X] CSRF Token
  • [X] Substituting base url (for testing)
  • [X] Proxy support
• [ ] Messages
  • [ ] Getting all messages
  • [ ] Getting new messages
  • [ ] Sending
• [X] Lots
  • [X] Get fields
  • [X] Get lots
  • [X] Update lot
  • [X] Delete lot
  • [X] Create lot
• [X] Deploy
  • [X] Deploy into pkg.go.dev
  • [X] Improve documentation
  • [X] Tests