> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/help-center/it/integrations-and-api/api-documentation.md).

# Documentazione API

Creare un JOIN API token, autenticare le richieste JOIN API v3, e imparare come le versioni, limiti di tasso, impaginazione ed errori funzionano.

{% hint style="info" %}
**Chi può usare questo**

* **Piani:** Advanced e Enterprise
* **Roles:** System Admins
  {% endhint %}

## Iniziare

Questo riferimento ti aiuta a iniziare con il JOIN API v3, JOINREST API. API ti permette di interagire con il tuo JOIN dati programmaticamente – ad esempio, per ottenere elenchi di lavoro, recuperare applicazioni o gestire record candidati.

Il JOIN API è senza stato, il che significa che ogni richiesta deve includere l'autenticazione e non si basa sulle interazioni precedenti. API, avrete bisogno di creare un API token in JOIN.

Tutte le richieste v3 vanno a `https://api.join.com/v3`.

<a href="https://docs.join.com/reference/getting-started" class="button primary">Leggi tutto API documentazione</a>

***

## Autenticazione

Per convalidare il tuo API richieste, JOIN richiede un API token. Il gettone appartiene alla tua azienda, non a un singolo utente, e dà accesso solo ai dati della tua azienda in JOIN.

JOIN API accesso, compreso API le credenziali e la generazione di token, è disponibile solo su `Advanced` e `Enterprise` piani.

{% hint style="info" %}
Non vedo il `Developer` pagina? Solo System Admins può aprirlo. Se `Create token` apre un prompt di aggiornamento, controlla il tuo piano: fai clic sul tuo nome nell'angolo in basso a sinistra, seleziona `Impostazioni`, quindi selezionare `Billing`. Aggiornamento a `Advanced` o `Enterprise` da usare JOIN API e generare le credenziali.

Vedi [Piani di abbonamento](/help-center/it/plans-and-billing/subscription-plans.md) per i dettagli del piano e la guida di aggiornamento.
{% endhint %}

### Generare un API Token

1. Fare clic sul nome nell'angolo in basso a sinistra e selezionare `Impostazioni`.
2. Seleziona `Developer`.
3. Fare clic su `Create token`, inserire un nome e copiare il token dalla finestra che si apre.

La vostra azienda può avere fino a 10 token attivi.

{% hint style="warning" %}
Tieniti forte. API token sicuro. Fornisce l'accesso ai dati della tua azienda in JOIN, compresa la capacità di leggere, aggiornare o cancellare le informazioni.
{% endhint %}

### Utilizzare API Token

Invia il tuo token nel `Authorization` intestazione di ogni richiesta, come segno del Bearer: `Authorization: Bearer join_sk_…`. Nuovi gettoni iniziano con `join_sk_`.

Una richiesta senza un gettone ritorna `401 authentication_required`. Un token non valido o revocato, oppure utilizzato su un piano senza API accesso, restituisce `401 token_invalid`.

### Scegli una versione API

Il JOIN API v3 è versioneta per data. Inviare `Join-Version` intestazione per scegliere una versione. Senza di essa, JOIN usi `2026-11-01`. Una versione sconosciuta ritorna `400 unsupported_api_version`.

Si consiglia di inviare `Join-Version` su ogni richiesta, quindi la tua integrazione continua a funzionare quando viene rilasciata una nuova versione. [Versioni e compatibilità](https://docs.join.com/reference/versioning-and-depreciation).

**Esempio di richiesta:**

```bash
curl -X GET \
  https://api.join.com/v3/jobs \
  -H 'Authorization: Bearer your-api-token-here' \
  -H 'Join-Version: 2026-11-01'
```

### Rivolgiti a un API Token

È possibile revocare un token in qualsiasi momento `Impostazioni` → `Developer`. Tenete a mente che:

* Una volta revocato, il token smette di funzionare immediatamente
* I gettoni non possono essere riattivati o rigenerati
* È necessario aggiornare la vostra integrazione con un nuovo token se uno è revocato

***

## Limiti tariffari, impaginazione ed errori

* **Limiti di tasso:** ogni token può inviare 600 richieste al minuto, e al massimo 100 in 10 secondi. API restituisce `429 rate_limit_exceeded` con un `Retry-After` intestazione che dice quando provare di nuovo.
* **Paginazione:** liste di ritorno 10 record per impostazione predefinita, e `limit` accetta da 1 a 50. Per ottenere la pagina successiva, inviare la risposta `nextCursor` come `cursor`. Nell'ultima pagina, `nextCursor` è `null`.
* **Errori:** ogni errore viene come `{"error": {"code", "message", "details"}}`. `details` nomina i campi che non sono riusciti a convalidare.

Per i dettagli, vedere [Limiti di tasso](https://docs.join.com/reference/rate-limits), [Paginazione, filtraggio e smistamento](https://docs.join.com/reference/pagination) e [Risposte, errori e commenti](https://docs.join.com/reference/requests-and-responses).

***

## JOIN API v2

JOIN API v2 è deprecato. Costruire nuove integrazioni su v3, e pianificare di spostare le integrazioni v2 esistenti a v3.

* Esistente v2 API I loro valori non sono cambiati, quindi le tue integrazioni v2 continuano a funzionare. `Impostazioni` → `Developer`, chiamato dopo l'amministratore che possedeva la chiave.
* I nuovi gettoni che si creano in `Developer` funzionano anche su v2.

Per spostare un'integrazione da v2 a v3, vedere [Moving da v2 a v3](https://docs.join.com/reference/migration-guide-from-v2).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.join.com/help-center/it/integrations-and-api/api-documentation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.