docs/markdown/endpoints.md

25 lines
1.2 KiB
Markdown
Raw Normal View History

2019-08-12 11:30:43 +00:00
# API
## Balance Endpoint
```text
https://balance.api.global
```
api.global uses a balancing endpoint to balance clients between dynamic workers. The balance endpoint will assign you a dynamic endpoint,a secret that proves you got assigned that endpoint, a max timeframe that the worker is guranteed to be available and a max idle timeframe between requests, before your spot is given to the next api client balancing applicant. You can always come back here and ask for a new worker assignment.
## Async Endpoint
```text
https://async.api.global
```
For requests that are not sensitive for timely execution there is a async endpoint, that will schedule an request for "later point in time" exection. Any requests going there need to register a webhook within their account for transmitting responses in an asynchronious fashion.
## Worker Endpoints
2019-08-13 19:49:27 +00:00
```
2019-08-13 19:52:12 +00:00
https://[4chd76gf].api.global
2019-08-13 19:49:27 +00:00
```
Worker endpoints are assigned to you on a dynamic basis
!!! hint
If you are using TypeScript we can not recommend enough to use our TypeScript npm packages for super easy integration.
They are maintained by us ourselves and hide most complex stuff from you so you can focus on using the tools.