Skip to content

A simple forward proxy server for processing API calls to servers that don't send CORS headers or support HTTPS.

License

Notifications You must be signed in to change notification settings

Freeboard/thingproxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

thingproxy

A simple forward proxy server for processing API calls to servers that don't send CORS headers or support HTTPS.

what?

thingproxy allows javascript code on your site to access resources on other domains that would normally be blocked due to the same-origin policy. It acts as a proxy between your browser and a remote server and adds the proper CORS headers to the response.

In addition, some browsers don't allow requests for non-encrypted HTTP data if the page itself is loaded from HTTPS. thingproxy also allows you to access non-secure HTTP API's from a secure HTTPS url.

We encourage you to run your own thingproxy server with this source code, but freeboard.io offers a free proxy available at:

http://thingproxy.freeboard.io and https://thingproxy.freeboard.io

why?

Dashboards created with freeboard normally access APIs directly from ajax calls from javascript. Many API providers do not provide the proper CORS headers, or don't support HTTPS— thingproxy is provided to overcome these limitations.

how?

Just prefix any url with http(s)://thingproxy.freeboard.io/fetch/

For example:

https://thingproxy.freeboard.io/fetch/http://my.api.com/get/stuff

Any HTTP method, headers and body you send, will be sent to the URL you specify and the response will be sent back to you with the proper CORS headers attached.

caveats

Don't abuse the thingproxy.freeboard.io server— it is meant for relatively small API calls and not as a proxy server to hide your identity. Right now we limit requests and responses to 100,000 characters each (sorry no file downloads), and throttle each IP to 10 requests/second.

privacy

thingproxy.freeboard.io does log the date, requester's IP address, and URL for each request sent to it. We do not log headers or request bodies. We will not share or sell this data to anyone, period.

About

A simple forward proxy server for processing API calls to servers that don't send CORS headers or support HTTPS.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published