> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arquos.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Accéder à la fiche équipement

> Cette fonctionnalité permet d'afficher la fiche technique complète Arquos d'un équipement via la génération d'une URL sécurisée à usage unique.

### Endpoint & Authentification

| Méthode | URL                                               |
| :------ | :------------------------------------------------ |
| `POST`  | `https://app.arquos.eu/api/1.1/wf/generate_token` |

**En-têtes (Headers) :**

* `x-api-key: [VOTRE_API_KEY]`

<Note>
  La clé API est propre à chaque partenaire et n'est autorisée que sur les agences qui lui ont été attribuées. Un appel avec une clé invalide, ou visant une agence non autorisée, n'est pas exécuté.
</Note>

### Paramètres de la requête (Body)

<ParamField body="agency_id" type="string" required>
  Identifiant unique de l'agence.
</ParamField>

<ParamField body="equipment_number" type="string" required>
  Numéro de l'équipement concerné.
</ParamField>

### Spécifications de sécurité

<Warning>
  **Validité du jeton :** Le jeton (token) inclus dans l'URL a une durée de validité de **5 minutes**. Il doit être généré à chaque nouveau chargement de page sur votre plateforme.
</Warning>

### Réponse (Success 200)

L'API retourne une URL signée permettant un accès direct à la fiche technique.

<ResponseField name="url" type="string">
  URL sécurisée incluant le jeton unique.
</ResponseField>

<RequestExample>
  ```json JSON theme={null}
  {
    "agency_id": "test_agency_01",
    "equipment_number": "ASC_45678"
  }
  ```

  ```bash cURL theme={null}
  curl --request POST \
    --url https://app.arquos.eu/api/1.1/wf/generate_token \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "agency_id": "test_agency_01",
    "equipment_number": "ASC_45678"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "success",
    "response": {
      "url": "https://app.arquos.eu/equipment?token=SKd10nnKCq1zEs..."
    }
  }
  ```
</ResponseExample>

### Utilisation de l'URL

L'URL générée doit être utilisée exclusivement via une **redirection externe** ou l'ouverture d'un **nouvel onglet** dans le navigateur de l'utilisateur.

<Info>
  **Note sur l'intégration :** Pour des raisons de sécurité et d'expérience utilisateur, l'affichage de la fiche via une balise `<iframe>` n'est pas supporté.
</Info>

**Méthode recommandée :**

1. L'utilisateur clique sur un bouton "Voir la fiche technique" sur votre interface.
2. Votre backend appelle l'API `generate_token`.
3. Vous redirigez l'utilisateur vers l'URL reçue.