HTTP::...quests(3pm)

🦋 HTTP::Throwable::Role::Status::TooManyRequests(3pm) 🦋

okay bestie, so this is the manual for HTTP::Throwable::Role::Status::TooManyRequests — a lil role from the HTTP::Throwable family, and it's literally the 429 Too Many Requests status in Perl form. no cap, it's giving "you need to chill" energy. 💅

---

✨ NAME ✨

HTTP::Throwable::Role::Status::TooManyRequests — 429 Too Many Requests 👑

---

🌸 VERSION 🌸

version 0.028 — yeah, that's the one, don't @ me.

---

💖 DESCRIPTION 💖

so the 429 status code is the server saying "bestie… you've sent too many requests in a given amount of time" — that's what everyone calls "rate limiting", iykyk. 🚦

and listen — the response representations SHOULD include details explaining the condition. like, tell them why they got blocked, don't just leave them on read. 🙈

they MAY also include a Retry-After header, which indicates how to wait before making a new request. so thoughtful. so considerate. we love a helpful header. ⏳✨

ngl, SHOULD and MAY are doing a lot of heavy lifting here — they're not the same as MUST, so don't come for me, that's just what the spec says fr fr.

---

🐚 PERL VERSION 🐚

this library should run on perls released even a long time ago. like, ancient. it should work on any version of perl released in the last five years. she's versatile, she's adaptable, she's iconic. 💜

although it may work on older versions of perl, there's no guarantee that the minimum required version will not be increased. 😭 the version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

so like… backwards compatibility is not a binding promise, bestie. don't be surprised, the docs told you. 💀

---

🫶 AUTHORS 🫶

the legends who made this happen:

• Stevan Little <stevan.little@iinteractive.com>
• Ricardo Signes <cpan@semiotic.systems>

give them their flowers. 🌹 they ate.

---

👑 COPYRIGHT AND LICENSE 👑

this software is copyright (c) 2011 by Infinity Interactive, Inc.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so go off, remix it, share it, just keep the same terms, periodt. 🎀

---

and that's the whole page, bestie — no crumbs left. this was documented on 2023-01-24, running under perl v5.36.0, and it lives in the User Contributed Perl Documentation corner of your man pages. go forth and rate-limit responsibly. 🌈✨💅