Exemples

Blocs de code épinglés dans une barre latérale droite persistante sur desktop afin que les lecteurs puissent les consulter en faisant défiler la page. Sur mobile, ils s'affichent en ligne.

RequestExample

Utilisez RequestExample pour afficher le code d'une requête API. Plusieurs blocs de code créent des vues à onglets.

curl -X POST https://api.example.com/users \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "email": "john@example.com"}'

Utilisation :

<RequestExample>
```bash cURL
curl -X POST https://api.example.com/users \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "email": "john@example.com"}'
```
</RequestExample>

ResponseExample

Utilisez ResponseExample pour afficher les réponses API. Indiquez un code de statut et une description après l'identifiant de langage.

{
  "id": "usr_123",
  "name": "John Doe",
  "email": "john@example.com",
  "created_at": "2024-01-15T10:30:00Z"
}

Utilisation :

<ResponseExample>
```json 200: Success
{
  "id": "usr_123",
  "name": "John Doe",
  "email": "john@example.com",
  "created_at": "2024-01-15T10:30:00Z"
}
```
</ResponseExample>

Le code de statut détermine la couleur de l'indicateur :

• Vert - codes de succès 2xx
• Bleu - codes de redirection 3xx
• Ambre - erreurs client 4xx
• Rouge - erreurs serveur 5xx

Plusieurs langages

Ajoutez plusieurs blocs de code pour créer une interface à onglets :

curl -X GET https://api.example.com/users/123 \
  -H "Authorization: Bearer $TOKEN"

Utilisation :

<RequestExample>
```bash cURL
curl -X GET https://api.example.com/users/123 \
  -H "Authorization: Bearer $TOKEN"
```

```python Python
import requests

response = requests.get(
    "https://api.example.com/users/123",
    headers={"Authorization": f"Bearer {TOKEN}"}
)
user = response.json()
```

```javascript JavaScript
const response = await fetch("https://api.example.com/users/123", {
  headers: {
    "Authorization": `Bearer ${TOKEN}`
  }
});
const user = await response.json();
```

```go Go
package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.example.com/users/123", nil)
  req.Header.Set("Authorization", "Bearer TOKEN")

  resp, _ := (&http.Client{}).Do(req)
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}
```

```ruby Ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI("https://api.example.com/users/123")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer TOKEN"

response = http.request(request)
puts JSON.parse(response.body)
```
</RequestExample>

Plusieurs codes de réponse

Affichez différents scénarios de réponse avec des onglets séparés :

{
  "id": "usr_123",
  "name": "John Doe",
  "email": "john@example.com"
}

Utilisation :

<ResponseExample>
```json 200: Success
{
  "id": "usr_123",
  "name": "John Doe",
  "email": "john@example.com"
}
```

```json 400: Bad Request
{
  "error": "validation_error",
  "message": "Email is required"
}
```

```json 404: Not Found
{
  "error": "not_found",
  "message": "User not found"
}
```
</ResponseExample>

Utilisation combinée

Pour la documentation API, utilisez les deux composants ensemble. La requête apparaît au-dessus de la réponse dans la barre latérale :

curl -X POST https://api.example.com/orders \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_456",
    "quantity": 2
  }'

{
  "id": "ord_789",
  "product_id": "prod_456",
  "quantity": 2,
  "status": "pending",
  "created_at": "2024-01-15T10:30:00Z"
}

Utilisation :

<RequestExample>
```bash cURL
curl -X POST https://api.example.com/orders \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_456",
    "quantity": 2
  }'
```
</RequestExample>

<ResponseExample>
```json 201: Created
{
  "id": "ord_789",
  "product_id": "prod_456",
  "quantity": 2,
  "status": "pending",
  "created_at": "2024-01-15T10:30:00Z"
}
```
</ResponseExample>

Formats des codes de statut

ResponseExample prend en charge deux formats pour les codes de statut :

```json 200: Success      // Colon separator

```json 400 - Bad Request // Dash separator

Les deux formats sont analysés de manière identique et affichent le code de statut avec sa description dans l'onglet.

Et ensuite ?