mirror of
https://github.com/ngrok/ngrok-api-python.git
synced 2026-06-16 16:54:33 +00:00
40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
# Unstable
|
|
|
|
This library is currently unstable. We know of rough edges
|
|
and are working to bring it to parity with our other API client
|
|
libraries. Please feel free to try it out and let us know if you find
|
|
it useful!
|
|
|
|
# ngrok API client library for Python
|
|
|
|
This library wraps the [ngrok HTTP API](https://ngrok.com/docs/api) to make it
|
|
easier to consume in Python.
|
|
|
|
## Installation
|
|
|
|
This library is published on [PyPi](https://pypi.org/project/ngrok-api/)
|
|
|
|
pip install ngrok-api
|
|
|
|
## Documentation
|
|
|
|
A quickstart guide and a full API reference are included in the [ngrok python API documentation](https://python-api.docs.ngrok.com)
|
|
|
|
## Quickstart
|
|
|
|
Please consult the [documentation](https://python-api.docs.ngrok.com) for additional examples.
|
|
|
|
import ngrok
|
|
|
|
# construct the api client
|
|
client = ngrok.Client("<API KEY>")
|
|
|
|
# list all online tunnels
|
|
for t in client.tunnels.list():
|
|
print(t)
|
|
|
|
# create an ip policy that allows traffic from some subnets
|
|
policy = client.ip_policies.create()
|
|
for cidr in ["24.0.0.0/8", "12.0.0.0/8"]:
|
|
client.ip_policy_rules.create(cidr=cidr, ip_policy_id=policy.id, action="allow")
|