> For the complete documentation index, see [llms.txt](https://docs.ddtable.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ddtable.nl/welcome.md).

# Welcome!

## Welcome to the API documentation for ddtable.nl

This API has been developed to have a faster way of finding the Degree of Difficulty for a certain dive in high-diving and cliff-diving. The official tables by the World Aquatics organization (formerly FINA) have been used to make this.

## Authentication

To use the API you will need to create an account at <https://ddtable.nl/register>. There you can generate a token that can be used to authenticate the requests you send to the API.

The tokens are Bearer tokens that should be used as follows:

```
curl 'http://ddtable.test/api/dive/102C' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer IQyOCJ8PzbVRwJju3ffQct9MzAL16KnL1Uk3lwTZ'
```

## Rate Limiting

To keep the platform usable, the API is limited to 60 requests per minute and 1000 requests per day per user.

{% content-ref url="/pages/VEWttg5gpErzlMGNv0Lx" %}
[API Reference](/reference/api-reference.md)
{% endcontent-ref %}