Referencia del puente Java
Este enlace antiguo sin versión describe los tres endpoints del puente Java con clave API. No es la API JWT de V1 ni la nueva API de recursos V2. Selecciona la versión de tu integración.
API para desarrolladoresAutenticación
Autenticación
Envía JSON mediante HTTPS con la clave API completa en X-API-Key. Guárdala en el servidor, nunca en código del navegador, aplicaciones móviles, repositorios o registros. No envíes el token de acceso de la App, un token Bearer ni otro API secret: estos endpoints solo usan X-API-Key. OAuth no está disponible actualmente.
Administrar claves APIEncabezados
Content-Type: application/json X-API-Key: <your-api-key>
Guardar y administrar claves
Las claves nuevas solo se muestran completas una vez, al crearlas o rotarlas. La lista muestra un identificador enmascarado. No puedes recuperar una clave perdida: reemplázala y revoca la que no puedes usar. La sustitución no amplía sus permisos automáticamente.
Las claves nuevas caducan a los 365 días por defecto. Puedes elegir otra fecha futura o una clave sin caducidad. Las claves sin caducidad también se pueden pausar o revocar. Revisa la fecha en API Keys; los avisos automáticos de caducidad aún no están disponibles.
Pausar bloquea una clave de forma reversible; revocarla la bloquea permanentemente. La rotación crea una clave con los mismos permisos: cambia tu integración antes de que termine el período de solapamiento. El valor predeterminado es 24 horas y el máximo, 7 días; también puedes revocar la anterior inmediatamente.
Permisos
labels.read or labels.buy
labels.buy
labels.buy
Los tres endpoints existentes conservan sus permisos: labels.read o labels.buy permiten consultar tarifas; labels.buy permite comprar y cancelar etiquetas. Los permisos previstos, como labels.void, no sustituyen ni amplían estas autorizaciones. Las claves existentes no reciben nuevos scopes ni acceso a nuevos recursos automáticamente. Solo están disponibles las claves Live para los endpoints existentes; los nuevos permisos y las claves de prueba aún no están habilitados.
Respuesta
Responses use { code, message, data }. Check both the HTTP status and response code; provider errors are not successful purchases.