第4章：接入与认证

# 沙箱环境示例
curl -X POST "https://api.sandbox.onixportltl.com/ucauth/authc/account/createToken" \
  -H "X-Api-Key: 3F2504E04F8911D39A0C0305E82C3301" \
  -H "X-Api-Secret: L9Gf7bQ2xU3VjK1Yp8nR5wT0eXz6Hq2fAaJdKsLmQpU" \
  -H "Content-Type: application/json"

# 生产环境示例
curl -X POST "https://api.onixportsystem.com/ucauth/authc/account/createToken" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Api-Secret: your-api-secret" \
  -H "Content-Type: application/json"

{
  "success": true,
  "errorCode": null,
  "errorMsg": null,
  "result": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresIn": 86400
  }
}

{
  "success": false,
  "errorCode": 1404,
  "errorMsg": "Email address or password is not valid."
}

// 示例代码 - 使用 Redis 缓存
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import java.util.concurrent.TimeUnit;

public class TokenService {
    
    private static final String REDIS_KEY = "wms_api_token";
    private static final int CACHE_BUFFER = 5 * 60; // 提前5分钟失效（300秒）
    
    @Autowired
    private StringRedisTemplate redisTemplate;
    
    @Autowired
    private TokenApiClient tokenApiClient;
    
    /**
     * 获取 Token，优先从缓存获取，缓存不存在或过期时重新获取
     */
    public String getToken() {
        // 1. 尝试从缓存获取 Token
        String token = redisTemplate.opsForValue().get(REDIS_KEY);
        
        if (token != null && !token.isEmpty()) {
            // 缓存中存在，直接返回
            return token;
        }
        
        // 2. 缓存不存在或已过期，重新获取 Token
        TokenResponse tokenResponse = tokenApiClient.getNewToken();
        token = tokenResponse.getAccessToken();
        Long expiresIn = tokenResponse.getExpiresIn();
        
        // 3. 计算缓存过期时间（提前5分钟失效）
        long cacheExpireTime = expiresIn - CACHE_BUFFER;
        
        // 4. 将 Token 存入缓存，设置过期时间
        redisTemplate.opsForValue().set(REDIS_KEY, token, cacheExpireTime, TimeUnit.SECONDS);
        
        return token;
    }
}

// 使用示例
@Autowired
private TokenService tokenService;

String token = tokenService.getToken();
// 使用 token 调用业务接口

// 示例代码 - 使用本地缓存（内存）
import java.util.concurrent.atomic.AtomicLong;

public class TokenCacheService {
    
    private static final int CACHE_BUFFER = 5 * 60; // 提前5分钟失效（300秒）
    
    private String token;
    private AtomicLong expireTime = new AtomicLong(0);
    private final Object lock = new Object();
    
    @Autowired
    private TokenApiClient tokenApiClient;
    
    /**
     * 获取 Token，优先从本地缓存获取，缓存过期时重新获取
     */
    public String getToken() {
        long now = System.currentTimeMillis() / 1000; // 当前时间戳（秒）
        
        // 1. 检查缓存是否有效
        if (token != null && now < expireTime.get()) {
            return token;
        }
        
        // 2. 缓存无效，重新获取 Token（加锁防止并发）
        synchronized (lock) {
            // 双重检查，避免重复获取
            if (token != null && now < expireTime.get()) {
                return token;
            }
            
            TokenResponse tokenResponse = tokenApiClient.getNewToken();
            Long expiresIn = tokenResponse.getExpiresIn();
            
            // 3. 计算缓存过期时间（提前5分钟失效）
            long cacheExpireTime = now + expiresIn - CACHE_BUFFER;
            
            // 4. 更新缓存
            this.token = tokenResponse.getAccessToken();
            this.expireTime.set(cacheExpireTime);
            
            return this.token;
        }
    }
}

// 使用示例
@Autowired
private TokenCacheService tokenCacheService;

String token = tokenCacheService.getToken();
// 使用 token 调用业务接口