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

# Démarrage Rapide

> Effectuez votre premier appel API et découvrez UBIK en moins de 5 minutes.

Bienvenue dans l'API UBIK ! Ce guide vous accompagnera pour effectuer votre premier appel API en quelques minutes.

<Steps>
  <Step title="Obtenez votre clé API">
    Votre clé API est votre passeport pour l'écosystème UBIK. Vous en aurez besoin pour authentifier toutes vos requêtes API. Vous pouvez trouver votre clé API sur la page des paramètres de votre compte dans le tableau de bord UBIK.

    <Card title="Accéder aux paramètres de la clé API" icon="key" href="https://app.ubik-agent.com/user/security" />

    <Tip>
      Gardez votre clé API en sécurité comme un mot de passe et ne la partagez pas publiquement.
    </Tip>
  </Step>

  <Step title="Effectuez Votre Première Requête">
    Vérifions que votre clé API fonctionne correctement en récupérant les détails de votre utilisateur. Nous utiliserons l'endpoint `/users/me`, qui fournit des informations sur l'utilisateur authentifié.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X GET "https://app.ubik-agent.com/api/v1/users/me" \
           -H "X-API-KEY: VOTRE_CLE_API"
      ```

      ```python Python theme={null}
      import requests

      api_key = "VOTRE_CLE_API"
      headers = {
          "X-API-KEY": api_key
      }
      response = requests.get(
          "https://app.ubik-agent.com/api/v1/users/me",
          headers=headers
      )
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const apiKey = "VOTRE_CLE_API";
      const headers = {
        "X-API-KEY": apiKey,
      };

      fetch("https://app.ubik-agent.com/api/v1/users/me", {
        method: "GET",
        headers: headers,
      })
        .then((response) => response.json())
        .then((data) => console.log(data))
        .catch((error) => console.error("Erreur:", error));
      ```
    </CodeGroup>
  </Step>

  <Step title="Vérifiez la Réponse">
    Si tout est correct, vous recevrez une réponse `200 OK` avec un objet JSON contenant les détails de votre utilisateur.

    ```json Réponse theme={null}
    {
      "username": "testuser",
      "full_name": "Test User",
      "uuid_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "created_at": "2025-09-28T12:00:00Z",
      "balance": 100.0,
      "chat_session_count": 5,
      "document_count": 42,
      "workspace_count": 3,
      "assistant_count": 2,
      "skill_count": 1
    }
    ```
  </Step>
</Steps>

Félicitations ! Vous avez effectué avec succès votre premier appel API.

## Prochaines Étapes

Maintenant que vous êtes prêt, vous pouvez explorer davantage.

<CardGroup cols={2}>
  <Card title="Concepts Clés" icon="book-open" href="/fr/developement">
    Comprendre les éléments fondamentaux de l'API UBIK.
  </Card>

  <Card title="Guides Pas-à-Pas" icon="list-checks" href="/fr/guides/managing-workspaces">
    Suivez nos guides pour apprendre les scénarios d'utilisation courants.
  </Card>
</CardGroup>
