PRIMEROS PASOS / QUICKSTART
Empieza con la API de Revendedores
Cuando tengas un token de revendedor habilitado, puedes comprobar tu cuenta y listar tus tiendas con estas solicitudes de solo lectura.
01
Obtén un token habilitado
La API requiere un token de revendedor con el permiso stores:read. La pantalla pública de autoservicio para emitir tokens aún no está disponible; si todavía no tienes uno, solicita habilitación al responsable de tu cuenta Covaly.
El token completo se entrega una sola vez. Guárdalo de forma segura y no lo compartas en un chat ni en código público.
02
Guárdalo como variable local
Así evitas pegar el token repetidamente en cada comando.
# macOS / Linux
export COVALY_TOKEN="rsl_<tu_token>"
# PowerShell
$env:COVALY_TOKEN = "rsl_<tu_token>"03
Comprueba la conexión
Este endpoint muestra tu cuenta y los permisos asociados al token.
curl https://covaly.store/api/v1/reseller/me \
-H "Authorization: Bearer $COVALY_TOKEN" \
-H "Accept: application/json"Resultado esperado: una respuesta con reseller y token.scopes.
04
Lista tus tiendas
El token necesita el permiso stores:read.
curl https://covaly.store/api/v1/reseller/stores \
-H "Authorization: Bearer $COVALY_TOKEN" \
-H "Accept: application/json"Resultado esperado: una lista con tus tiendas, dominios, estado y fecha de vencimiento.
¿Qué sigue?
Ahora puedes crear una solicitud de tienda o conectar Covaly con un cliente MCP. Las acciones que usan créditos siempre requieren tu confirmación.