DEV Community

Cover image for Introducing ProxyCeptor: A Simpler Way to Handle APIs
Arun for Ceptor Labs

Posted on

Introducing ProxyCeptor: A Simpler Way to Handle APIs

_Have you ever wanted to test one small API change, but ended up spending more time setting up the environment than actually testing it?
_
Maybe you want an API to return a 500.

Maybe you want to change one field in a response.

Maybe you want to redirect a request to staging.

Or maybe you just want to see what happens when an API takes 3 seconds to respond.

Usually, you end up changing backend code, creating temporary mocks, deploying something to staging, or setting up a proxy and dealing with certificates.

That is where ProxyCeptor comes in.

Try ProxyCeptor

What is ProxyCeptor?

ProxyCeptor is a developer tool for intercepting and modifying API traffic while your application is running.

Instead of changing your backend just to test a frontend scenario, you can intercept the request and change what happens to it.

For example:

Application
     ↓
  API Request
     ↓
 ProxyCeptor
     ↓
Modify / Mock / Delay / Block
     ↓
    API
Enter fullscreen mode Exit fullscreen mode

You can modify requests, change responses, mock APIs, redirect URLs, inject headers, simulate errors, and introduce network delays.

The idea is pretty simple:

Don't change your application just to test a different API scenario. Change the traffic instead.

A simple example

Imagine your API normally returns:

{
  "status": "success",
  "user": {
    "name": "John"
  }
}
Enter fullscreen mode Exit fullscreen mode

You want to see how your frontend behaves when the API returns an error.

Instead of modifying the backend, you can make the response behave like:

{
  "status": "error",
  "message": "Something went wrong"
}
Enter fullscreen mode Exit fullscreen mode

You can also simulate HTTP errors such as 401, 404, 500, or 503, or add artificial latency to see how your UI handles slow networks.

ProxyCeptor supports these kinds of request and response modifications directly.

What can you do with it?

Some of the useful things you can do are:

  • Modify request URLs
  • Change request payloads
  • Inject or modify headers
  • Mock complete API responses
  • Modify only specific JSON fields
  • Redirect requests
  • Block network traffic
  • Simulate API delays
  • Change HTTP status codes
  • Transform API responses

One feature I particularly like is JSON Deep Merge.

Instead of replacing an entire response, you can change only the field you care about while keeping the rest of the real API response intact.

That makes testing much less painful.

No backend changes

This is probably the biggest reason to use a tool like this.

Suppose you're working on a frontend feature that needs to handle:

"What happens when the payment API returns 503?"

You shouldn't have to ask the backend team to create a special response, deploy it, test it, and then revert it.

You can simulate that response locally and continue working.

That means frontend developers and QA engineers can test edge cases without waiting for backend changes.

And it isn't limited to browsers

ProxyCeptor can also work with Smart TV environments such as Android TV, Fire TV, Samsung Tizen, and LG webOS.

For environments where installing a root SSL certificate or configuring a traditional system proxy is painful, ProxyCeptor provides an SDK-based approach that intercepts traffic inside the application runtime.

That makes it useful for testing things that are otherwise surprisingly difficult to reproduce on real devices.

The idea behind ProxyCeptor

The goal isn't to replace your existing testing framework.

Unit tests still have their place.

Integration tests still have their place.

Mock servers still have their place.

ProxyCeptor is useful for that layer in between:

"I'm running the real application, making real requests, but I want to control what happens to those requests."

That's where API interception becomes really useful.

You can inspect the traffic, change it, reproduce an edge case, and see how your actual application reacts.

No temporary backend endpoint.

No waiting for another deployment.

Just change the traffic and test.

Give it a try

If you're working with APIs, frontend applications, QA testing, or Smart TV applications, you can try ProxyCeptor here:

https://proxyceptor.com/

There is also a live sandbox where you can experiment with API interception without setting up a project first.

I'd be interested to know how other developers handle this today.

Do you use Charles, Burp, Postman, browser DevTools, mock servers, or something else when you need to change API behavior during development?

Top comments (1)

Collapse
 
arun_ceptorlabs profile image
Arun Ceptor Labs •

Please share your honest criticism of ProxyCeptor. We’ll take your feedback seriously, address the issues you identify, and come back with improvements.