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

# Autenticación

> Autentique las solicitudes a cada API de PapelShip con su clave de API.

Cada solicitud debe incluir una clave de API. Cada API acepta un conjunto de encabezados ligeramente distinto.

> [tab] User API
>
> Envíe su clave de API **y** el hash de su tienda en cada solicitud.
>
> ```bash theme={"system"}
> x-api-key: your_api_key
> x-store-hash: your_store_hash
> ```
>
> | Encabezado | Descripción |
> | :- | :- |
> | `x-api-key` | Su clave de API personal, obtenida en la configuración del panel. |
> | `x-store-hash` | El identificador único de su tienda. |

> [tab] qPapel Protection
>
> Envíe su clave de desarrollador (`pk_live_...`) de una de estas tres formas.
>
> ```bash theme={"system"}
> # Recomendada
> Authorization: Bearer pk_live_your_key
>
> # Alternativa
> x-api-key: pk_live_your_key
>
> # Heredada (compatible con loaders antiguos)
> api-key: pk_live_your_key
> ```

## Pruebe sus credenciales

Llame al endpoint de conectividad de la User API para confirmar que su clave y el hash de su tienda funcionan:

```bash theme={"system"}
curl https://app.papelship.com/api/v1/me \
  -H "x-api-key: your_api_key" \
  -H "x-store-hash: your_store_hash"
```

Una solicitud válida devuelve `"success": true`. Una clave no válida devuelve `401 Unauthorized`.

## Proteja sus claves

> [accordion] Use las claves solo en su servidor
>
> Las claves de API otorgan acceso total a su tienda y a sus licencias. Nunca las incluya en JavaScript de frontend, aplicaciones móviles ni binarios de escritorio distribuidos.

> [accordion] Guarde las claves en variables de entorno
>
> Cargue las claves desde variables de entorno o un gestor de secretos. Nunca las suba al control de versiones.

> [accordion] Rote de inmediato una clave filtrada
>
> Si una clave queda expuesta, revóquela en el panel y cree una nueva.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.