# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ddtable.nl/welcome.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.