WWW::G...:Agent(3pm)

💖 WWW::G...:Agent(3pm) 💖

okay bestie, this is the manual page for WWW::G...:Agent(3pm), straight outta User Contributed Perl Documentation, and it's literally the whole vibe for talking to GoodData's JSON API. pull up a chair, grab a boba, we're doing this 🧋✨

---

🌸 NAME 🌸

WWW::GoodData::Agent — an HTTP client for the GoodData JSON-based API. that's it, that's the whole personality 💅

---

🎀 SYNOPSIS 🎀

  use WWW::GoodData::Agent;
  my $ua = new WWW::GoodData::Agent;
  my $metadata = $ua->get ('/md');

like… three lines and you're already fetching metadata. we love a low-effort queen 👑

---

🦋 DESCRIPTION 🦋

so WWW::GoodData::Agent is an HTTP user agent whose whole thing is making it easy to follow the specifics of the GoodData service API. it handles the conversion to and from JSON content type transparently (no cap, you don't have to think about it), and it recognizes and handles all the various kinds of exceptions and error states that come your way. it's giving ✨emotional support HTTP client✨.

and listen — it's a subclass of LWP::UserAgent and it follows LWP::UserAgent's semantics, unless documented otherwise. so if you already know your way around LWP::UserAgent, you're basically home. periodt. 💜

---

🫶 PROPERTIES 🫶

• root — a URI object pointing to the root of the service API. this is the main character that gets used to resolve relative request paths. 🎯

---

👑 METHODS 👑

🌈 new ROOT, PARAMS

creates a shiny new agent instance, bestie. the first argument is the root of the service API, and the rest of the args get passed straight through to LWP::UserAgent as is — no meddling, no editing, we just hand them over 🫴.

compared to a stock LWP::UserAgent, it comes with a memory-backed cookie storage and it sets the Accept header to prefer JSON content. so it already knows what it wants. iconic. 🍪

🌈 post URI, BODY, PARAMS

constructs and issues a POST request, obviously 💌.

compared to stock LWP::UserAgent, there's an extra body parameter, and that body gets encoded into JSON and set as the request content. and heads up — that is the only way to set the request content. no sneaky alternate routes, bestie 🚫.

the rest of the parameters are passed to LWP::UserAgent untouched. hands off 💅

🌈 put URI, BODY, PARAMS

constructs and issues a PUT request. same energy as POST, different verb 🔁.

compared to stock LWP::UserAgent, there's an extra body parameter that gets encoded into JSON and set as the request content — and again, that's the only way to set the request content, fr fr.

the rest of the parameters are passed to LWP::UserAgent untouched. 🫶

🌈 delete URI

a convenience method for constructing and issuing a DELETE request. short, sweet, unbothered, moisturized 💅✨

🌈 request PARAMS

this call is the common one for all request types — the group chat everyone's in 📱.

the API is the same as stock LWP::UserAgent, but relative URIs are permitted, and extra content processing happens with the response. so extra. we stan.

namely: errors are either handled or turned into exceptions, and known content types (that's JSON bestie) get decoded. so you're not out here parsing raw strings like it's 2009 😭

---

💀 SEE ALSO 💀

• <https://secure.gooddata.com/gdc/> — the Browsable GoodData API. go peek, it's a whole experience 🔍
• LWP::UserAgent — the Perl HTTP client that raised this one 🍼

---

📜 COPYRIGHT 📜

Copyright 2011, 2012, 2013 Lubomir Rintel

Copyright 2012 Jan Orel

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. (yes bestie, it's free, go off 🕊️)

---

🎤 AUTHOR 🎤

Lubomir Rintel lkundrak@v3.sk — the icon, the legend, the moment 👑

---

and that's the whole page, bestie! no details skipped, no options dropped, every single fact intact 💖

this was WWW::G...:Agent(3pm) from perl v5.42.0, dated 2025-07-25 — go forth and make JSON requests, you absolute main character 🦋💅🌸