Simplicity is the ultimate sophistication
20 Mar 26
At Transparent Edge, our commitment lies in providing our clients with the technical and human resources necessary to guarantee both the performance and security of their websites and applications. And 2026, which has only just begun to take its first steps, is absolutely no exception.
“Any sufficiently advanced technology is indistinguishable from magic”—or at least, that’s what Arthur C. Clarke, the renowned science fiction writer and author of notable works such as 2001: A Space Odyssey, claimed in 1962. More than sixty years have passed since then, and that statement is perhaps even more relevant today following the dizzying revolution of Artificial Intelligence, which has burst onto the scene like an explosion, shaking the foundations of our industry. To put it bluntly, poor HAL 9000—the AI that governed the Discovery One in 2001—has been left in the dust by high-speed engines like ChatGPT, Claude, Copilot, or Gemini. What was nothing more than science fiction until recently has inexorably, and almost irreverently, become reality.
At Transparent Edge, we are by no means strangers to this new reality. A prime example is the inclusion of our brand-new AI agent to assist our clients with VCL code recommendations. Combined with our recently added easy setup, this facilitates the deployment of new configuration adjustments, thereby minimizing the learning curve involved in using the Varnish Enterprise DSL (domain-specific language). All of this results in the continuous improvement of our product, of which our dashboard is the most visible exponent.
In any case, contrary to what one might think and with all due respect to Arthur C. Clarke, true magic does not reside in technology but in human talent—and at Transparent Edge, we know a lot about that. Under this premise, the expertise of our front-end and user experience teams, who are responsible for developing our dashboard, plays a crucial role. This is especially true of our back-end team, responsible for the development of our API: the very foundation upon which our dashboard is built, feeding it with data and logic. As Winston Churchill would say: never have so many owed so much to so few. If our dashboard is the visible face, our API is the brain that orchestrates our infrastructure and our services—an API that, moreover, Transparent Edge makes available to its clients.
Thus, until now, our clients have had the ability to interact with our API by consuming its endpoints to perform tasks such as: analyzing real-time traffic, consulting historical data, provisioning new sites or backends, adjusting configurations, managing digital certificates, administering users, invalidating content, and more. Furthermore, Transparent Edge has long offered integration with tools such as Terraform—through our own provider—as well as Prometheus and WordPress, via the W3 Total Cache plugin.
Today, Transparent Edge is also proud to offer a new, free command-line interface (CLI) tool: TE-API. Developed in Python, TE-API is designed to encapsulate, structure, and unify our API, allowing for an incredibly simple, secure, and efficient interaction with all the services it offers. Furthermore, thanks to the OpenAPI specification, TE-API will always stay up to date with all available endpoints.
This tool independently handles user authentication through the OAuth2 delegated authorization standard. This means it is no longer necessary to manually request a token by consuming the /v1/oauth2/access_token/ endpoint. Now, you only need to configure your credentials in a .env file or define the TRANSPARENT_CLIENT_(ID|SECRET) environment variables with said credentials… et voilà: TE-API will “automagically” (may Arthur C. Clarke forgive us…) handle obtaining and subsequently renewing the corresponding token.
[alberto@MacBook-Air 189 16:00] ~ (21 files, 504K)
✔ (0 jobs) $ env | grep -E 'TRANSPARENT_CLIENT_(ID|SECRET)'
TRANSPARENT_CLIENT_ID=<...>
TRANSPARENT_CLIENT_SECRET=<...>
[alberto@MacBook-Air 455 16:00] ~ (21 files, 504K)
✔ (0 jobs) $ te-api
audit autoprovisioning bot-mitigation companies core login media security show-context storage
authentication billing clear-company completion inventory logs notifications set-company statistics users
[alberto@MacBook-Air 455 16:00] ~ (21 files, 504K)
✔ (0 jobs) $
From this point forward, we can interact with the tool using a hierarchical and intuitive structure:
te-api [MODULE] [VERB] [RESOURCE] [OPTIONS].
For example:
[alberto@MacBook-Air 246 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get current-user | jq '(.first_name + " " + .last_name)'
"Alberto Suárez"
[alberto@MacBook-Air 266 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get sites --company-id <...> | jq -r '.[] | .url' | sort
mi-sitio.es
otro-sitio.es
www.mi-nuevo-site.es
www.mi-sitio.es
www.my-site.com
www.other-site.com
www.otro-sitio.es
[alberto@MacBook-Air 276 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies create invalidate --company-id <...> --json-body '{ "urls": ["https://www.mi-sitio.es/"] }'
{
"urls_to_send": [
"https://www.mi-sitio.es/"
],
"locked_urls": []
}
[alberto@MacBook-Air 245 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get invalidate --company-id <...>
{
"total": 1,
"data": [
{
"id": 752974895,
"user": "asuarez@transparentedge.eu",
"urls": [
"https://www.mi-sitio.es/"
],
"invalidation_type": 1,
"refetch": false,
"date": "2026-03-19T15:10:15.487469Z",
"soft": false
}
]
}
[alberto@MacBook-Air 215 16:00] ~ (21 files, 508K)
✔ (0 jobs) $
Thus, thanks to TE-API, we have instantly eliminated the tedious need to manually construct HTTP requests to consume our API endpoints, leaving a clean and simple interface in its place. And it is there, in simplicity, where the ultimate sophistication lies. Pure magic.
Alberto Suárez López is a Systems Administrator at Transparent Edge.
More Asturian than cider, Alberto studied Technical Engineering in Management IT and earned a postgraduate degree in Web Engineering from the University of Oviedo. Since then, he’s faced every type of UNIX infrastructure imaginable—and mastered them all—thanks to his deep knowledge that makes him an all-terrain problem-solver for any technical challenge.