> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agregar ejemplos de SDK

> Muestra fragmentos de código específicos por idioma junto a tus endpoints de API para enseñar a los desarrolladores cómo usar tus SDK

Si tus usuarios interactúan con tu API mediante un SDK en lugar de directamente a través de una solicitud de red, puedes usar la extensión `x-codeSamples` para agregar ejemplos de código a tu documento de OpenAPI y mostrarlos en tus páginas de OpenAPI.

Esta propiedad se puede agregar a cualquier método de solicitud y tiene el siguiente esquema.

<ParamField body="lang" type="string" required>
  El idioma del ejemplo de código.
</ParamField>

<ParamField body="label" type="string">
  La etiqueta del ejemplo. Es útil cuando se proporcionan varios ejemplos para un mismo endpoint.
</ParamField>

<ParamField body="source" type="string" required>
  El código fuente del ejemplo.
</ParamField>

Aquí tienes un ejemplo de fragmentos de código para una aplicación de seguimiento de plantas, que incluye tanto una herramienta de CLI en Bash como un SDK de JavaScript.

```yaml theme={null}
paths:
  /plants:
    get:
      # ...
      x-codeSamples:
        - lang: bash
          label: Listar todas las plantas sin regar
          source: |
            planter list -u
        - lang: javascript
          label: Listar todas las plantas sin regar
          source: |
            const planter = require('planter');
            planter.list({ unwatered: true });
        - lang: bash
          label: Listar todas las plantas en maceta
          source: |
            planter list -p
        - lang: javascript
          label: Listar todas las plantas en maceta
          source: |
            const planter = require('planter');
            planter.list({ potted: true });
```