What is an endpoint?

An endpoint is a sub-domain to serve as an API endpoint. These endpoints are public just like the real API endpoints. Anyone with the URL can send requests, anyone having a link to the dashboard can view requests and responses. Each endpoint gets a dedicated sub-domain as my-endpoint.proxy.beeceptor.com.

How to set up mocking?

Rules help you send canned/pre-defined responses when a request path matches. You can get started by sending a request and then clicking 'Create Rule'.

What is a dashboard?

A dashboard is a place you can intercept and review all incoming requests coming to an endpoint. Beeceptor dashboard acts as an interceptor. When you make a request to my-endpoint.proxy.beeceptor.com, request & responses are visible on the dashboard page beeceptor.com/console/my-endpoint to inspect the payloads.

Are the endpoints secure or private?

Free endpoints are public.

• Anyone having a link to the dashboard can see incoming requests. Copy and share dashboard URL.
• On the dashboard, you see the number of online users for that endpoint.

Is there an HTTPs support?

Yes! Beeceptor supports HTTPs. You can send requests with HTTP and HTTPs, both.

Does it support Cross-Origin Resource Sharing (CORS)?

Beeceptor supports CORS by default. This will ease out making a cross-domain call from a webpage. (1) All OPTIONS calls are accepted. (2) Any mock/rules you create, Beeceptor adds a response header Access-Control-Allow-Origin: * making API consumption easier.

How can I use 'Proxy Setup'?

Proxy Setup helps you route requests to a target domain. You can create mock rules to manipulate specific requests instead of sending to the target domain. For example, you can create a rule matching HTTP's GET method and request path /my/api/path and send a 403 status code instead of 200 which the target domain would have sent.

1. When the rules are enabled, they are matched in the listed order. The first matched rule is evaluated to send a response. If no rule is matched, the target endpoint is hit as usual.
2. When the rules are disabled or no rule matches, the endpoint routes the request to the target endpoint.

Can I use this for load/performance testing? (i.e. 100+ requests/sec)

Yes, with paid plans. Refer pricing page to find a suitable plan and upgrade.

Can I see request history for an endpoint?

Yes, with the Team plan. Refer Request History documentation.

How much does it cost?

(1) Beeceptor is free for public endpoints with a limit on daily requests. Feel free to spread your love and share feedback.
(2) We give awesome features for paid plans. (e.g private endpoints, request history, sharing, email support, APIs, etc.) Refer to the pricing page.

Can I create mocking rules using APIs?

Yes. You can use Beeceptor APIs to create/update mocking rules. In addition, you can retrieve request history. Refer to the API Documentation page.

What about privacy?

Beeceptor is a request interceptor and a router. If the dashboard page is open, these are sent over web-socket to inspect. Anyone with a dashboard page open can view and inspect request and response payloads. The server persists information about the endpoint (like settings, rules, etc) and requests (like target URL, headers and payloads of requests and responses, no. of hits to an endpoint, etc).

Notes:

• You are advised not to send production secrets, passwords or api-keys in any of these: headers/body/payload/URL
• You are advised to use private endpoints (available with paid plans).
• You are advised to create endpoints with unique or difficult to guess names.

How long Beeceptor store these requests?

• All the requests are stored for 10 days. These are purged thereafter.
• Beeceptor stores application logs for 30 days for audit, support and monitoring the service. The logs capture required information like request-path, status-code, source-ip, etc. The logs do not store request/response payloads and headers.

How do I delete an endpoint?

There is no self-service way to delete endpoints. These are cleaned up after a certain period of non-usage.

• For a free endpoint, you can delete all the mocking-rules, proxy-setup, etc, and release it for others to use. As these are public in nature, other users can use this anytime.
• For a paid endpoint, you can reach out to support to purge/delete the endpoint. These are never purged.
• The requests and responses are purged after 10 days.

How do I delete my account?

You can delete your account with Beeceptor. Once you are logged in, visit the 'Edit Account' page to delete your account.

How Beeceptor is different from RequestBin or Mocky.io?

RequestBin helps by letting us inspect what the client is sending, and Mocky.io creates dummy endpoints to send mocked responses. Beeceptor covers both in one tool letting you inspect requests and build mock responses.

In addition, Beeceptor has more features to be your one-stop API development companion.

• Proxying: It routes the traffic to the original Rest API when needed.
• Dynamic responses: Get dynamic mock responses based on request payloads.
• Generate fake data and make API responses look real.
• Beeceptor APIs allow you deeper integration with CI and Integration Tests.
• Local tunneling to help you with webhook development.

Use-cases

• Mock a rest API in seconds.
• Build a fake API without any coding.
• Customizable responses to simulate API response and failures.
• Load testing your APIs without passing the load to the downstream APIs.
• Simulate latencies and timeouts of downstream APIs (validate rarely reachable code paths)
• Local tunneling for webhook development. Expose your local port to the world.
• Goodbye to the static mocked response. You can now send dynamic responses by picking request payload parameters.
• A/B testing by switching API endpoints or versions without any redeployment. (prod code vs new code)
• Don't block your UI devs when backend APIs are still in development. Just mock it!
• Create endpoints for webhooks and inspect incoming payloads.