La API pública de ControlResell
Automatice su negocio desde sus propios scripts y herramientas: lea sus cuentas, artículos y conversaciones con una clave de API.
La API pública se está desplegando. Está reservada a las suscripciones que la incluyen y se abre de forma progresiva: la página de gestión de claves aún no es visible en todas las cuentas. Sin acceso, la API responde con un error 402.
Generar su clave de API
Las claves se crean en la aplicación, con su sesión. Una clave no puede crear, listar ni revocar otra clave.
- Inicie sesión en la aplicación web de ControlResell.
- Abra Ajustes y después Desarrolladores.
- Cree una clave: póngale un nombre, marque al menos un permiso y, si lo desea, una fecha de caducidad (5 años como máximo).
- Copie el secreto de inmediato: solo se muestra una vez.
El secreto empieza por cr_live_. Trátelo como una contraseña: ControlResell solo conserva una huella y no puede mostrarlo de nuevo. Ante la duda, revoque la clave y cree otra.
Envíe la clave en la cabecera Authorization de cada llamada. Ejemplo para leer su perfil:
curl https://api.controlresell.com/api/public/v1/me \
-H "Authorization: Bearer cr_live_..."Puede tener 10 claves activas como máximo, cada una revocable en cualquier momento.
Permisos disponibles
accounts:read– Lectura de las cuentas de marketplaceitems:read– Lectura de los artículos y sus anunciositems:write– Escritura de artículosorders:read– Lectura de pedidosconversations:read– Lectura de conversacionesconversations:write– Escritura de conversaciones
Documentación de la API
La referencia interactiva (Swagger) y la especificación OpenAPI son públicas y se generan desde la API en producción.
La API está versionada (/api/public/v1). La v1 solo evoluciona añadiendo; ante una ruptura se abre una v2 y la v1 sigue disponible al menos doce meses tras el anuncio.
SDK y CLI oficiales
SDK generados desde la especificación y una CLI, de código abierto en GitHub.
- Kotlincontrolresell/kotlin-sdkVer el repositorio
- TypeScriptcontrolresell/typescript-sdkVer el repositorio
- Pythoncontrolresell/python-sdkVer el repositorio
- Javacontrolresell/java-sdkVer el repositorio
- Gocontrolresell/go-sdkVer el repositorio
- Línea de comandoscontrolresell/cliVer el repositorio
Los paquetes aún no están publicados: próximamente en npm, PyPI y Maven Central. Mientras tanto, el código fuente está disponible en GitHub.