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

# Introduction

> Bienvenue dans la documentation de l'API Qwoty

## Bienvenue dans l'API Qwoty

<Steps>
  <Step title="Se connecter à Qwoty">
    Visitez [qwoty.app](https://qwoty.app) et connectez-vous à votre compte
  </Step>

  <Step title="Accéder aux paramètres développeur">
    Allez dans **Paramètres** → **Développeur** → **Jetons API**
  </Step>

  <Step title="Générer un nouveau jeton">
    Cliquez sur **Créer un jeton API** et donnez-lui un nom descriptif
  </Step>

  <Step title="Sauvegarder votre jeton">
    Copiez et stockez votre jeton API en lieu sûr. Il commence par `qwoty_`

    <Warning>
      Votre jeton API ne sera affiché qu'une seule fois. Conservez-le en lieu sûr !
    </Warning>
  </Step>
</Steps>

## Effectuer votre première requête

Récupérons vos conditions de paiement à l'aide de cURL :

```bash theme={null}
curl https://qwoty.app/api/payment-terms \
  -H "Authorization: Bearer qwoty_your_api_token_here"
```

<Tip>Remplacez `qwoty_your_api_token_here` par votre vrai jeton API</Tip>

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Net 30",
      "api_name": "net_30",
      "is_active": true,
      "installments": [
        {
          "name": "Full Payment",
          "percentage": 100,
          "term": "net30",
          "order_number": 1
        }
      ]
    }
  ]
}
```

## Utiliser différents langages

<CodeGroup>
  ```javascript JavaScript (fetch) theme={null}
  const response = await fetch('https://qwoty.app/api/payment-terms', {
    headers: {
      Authorization: 'Bearer qwoty_your_api_token_here',
    },
  })

  const data = await response.json()
  console.log(data)
  ```

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

  headers = {
      'Authorization': 'Bearer qwoty_your_api_token_here'
  }

  response = requests.get(
      'https://qwoty.app/api/payment-terms',
      headers=headers
  )

  data = response.json()
  print(data)
  ```

  ```typescript TypeScript theme={null}
  interface PaymentTerm {
    id: string
    name: string
    api_name: string
    is_active: boolean
    installments: Array<{
      name: string
      percentage: number
      term: string
      order_number: number
    }>
  }

  const response = await fetch('https://qwoty.app/api/payment-terms', {
    headers: {
      Authorization: 'Bearer qwoty_your_api_token_here',
    },
  })

  const data: { success: boolean; data: PaymentTerm[] } = await response.json()
  ```
</CodeGroup>

## Étapes suivantes

<CardGroup cols={2}>
  <Card icon="rocket" href="./developers/quickstart" title="Démarrage rapide">
    Obtenez votre clé API et effectuez votre première requête en quelques minutes
  </Card>

  <Card icon="key" href="./developers/authentication" title="Authentification">
    Apprenez comment authentifier vos requêtes API
  </Card>

  <Card icon="book-open" href="./api-reference/overview" title="Référence API">
    Explorez toutes les ressources et tous les points de terminaison API disponibles
  </Card>

  <Card icon="life-ring" href="mailto:support@qwoty.io" title="Assistance">
    Besoin d'aide ? Notre équipe est là pour vous aider
  </Card>
</CardGroup>

## Fonctionnalités de l'API

<AccordionGroup>
  <Accordion title="Architecture RESTful">
    Notre API suit les principes REST avec des URL orientées ressources prévisibles,
    accepte des corps de requête encodés en JSON et retourne des réponses encodées en JSON.
  </Accordion>

  <Accordion title="Gestion complète des erreurs">
    Des messages d'erreur clairs accompagnés de codes de statut HTTP appropriés vous aident à
    identifier et résoudre rapidement les problèmes.
  </Accordion>

  <Accordion title="Isolation par espace de travail">
    Toutes les opérations API sont limitées à votre espace de travail, garantissant la sécurité
    et l'isolation des données.
  </Accordion>
</AccordionGroup>

## URL de base

Toutes les requêtes API doivent être effectuées vers :

```
https://qwoty.app/api
```

## Besoin d'aide ?

<CardGroup cols={2}>
  <Card icon="envelope" href="mailto:support@qwoty.io" title="Assistance par e-mail">
    [support@qwoty.io](mailto:support@qwoty.io)
  </Card>

  <Card icon="browser" href="https://qwoty.app" title="Tableau de bord">
    Accédez à votre tableau de bord Qwoty
  </Card>
</CardGroup>