Swift 3中如何生成符合API要求的JSON字符串？

兄弟，你这个嵌套对象的思路完全找对方向了！手动拼接JSON字符串不仅写起来繁琐，后期API结构一改动简直要疯，必须换成结构化的模型方式来处理，既清晰又好维护。

针对你说的嵌套结构（Data对象→Image对象→Inputs对象...），我们可以用自定义模型+JSON原生序列化的方式来实现，完全替代手动拼接。下面给你一步步演示：

1. 定义对应API结构的嵌套模型 #

首先根据API要求的JSON格式，一层一层定义结构体（用结构体比类更轻量，适合这种数据模型），每个模型实现转字典的方法，方便后续序列化：

// 注意别和Foundation的Data重名，这里叫ImageData
struct ImageData {
    let content: String // 假设API需要的是base64图片内容
    
    // 转成字典，供上层模型使用
    func toDictionary() -> [String: Any] {
        return ["content": content]
    }
}

struct Image {
    let data: ImageData
    
    func toDictionary() -> [String: Any] {
        return ["data": data.toDictionary()]
    }
}

struct Inputs {
    let image: Image
    
    func toDictionary() -> [String: Any] {
        return ["image": image.toDictionary()]
    }
}

// 顶层请求模型，对应整个JSON结构
struct APIRequestModel {
    let inputs: Inputs
    
    func toDictionary() -> [String: Any] {
        return ["inputs": inputs.toDictionary()]
    }
    
    // 转成JSON Data，直接用于请求体
    func toJSONData() throws -> Data {
        // options如果用.prettyPrinted可以生成格式化的JSON，方便调试
        return try JSONSerialization.data(withJSONObject: toDictionary(), options: [.prettyPrinted])
    }
}

2. 生成请求用的JSON数据 #

接下来就可以用这些模型来构建请求数据了，完全不用手动拼字符串：

// 假设你已经把图片转成了base64字符串
let imageBase64 = "your-base64-image-content-here"

// 逐层创建模型对象
let imageData = ImageData(content: imageBase64)
let image = Image(data: imageData)
let inputs = Inputs(image: image)
let requestModel = APIRequestModel(inputs: inputs)

do {
    // 转成JSON Data
    let jsonData = try requestModel.toJSONData()
    
    // 调试时可以把Data转成字符串打印，检查格式是否符合API要求
    if let jsonString = String(data: jsonData, encoding: .utf8) {
        print("生成的JSON：\n\(jsonString)")
    }
    
    // 构建请求并发送
    guard let apiUrl = URL(string: "your-api-endpoint-url") else {
        print("URL无效")
        return
    }
    var request = URLRequest(url: apiUrl)
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = jsonData
    
    // 这里发起请求（用URLSession或者你常用的网络库）
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
        // 处理响应...
    }
    task.resume()
} catch {
    print("JSON序列化失败：\(error.localizedDescription)")
}

3. 关键注意点 #

• 字段名严格匹配：模型里的key（比如"content"、"data"、"image"）必须和API要求的JSON字段完全一致，大小写都不能错，这是很多人踩坑的地方。
• 调试技巧：一定要打印生成的JSON字符串，和API文档里的示例对比，看有没有结构错误（比如少嵌套一层、字段名写错）。
• 如果觉得手动写toDictionary()麻烦，Swift 3也可以用第三方库SwiftyJSON来简化模型转JSON的过程，但原生方案已经足够可靠，不用额外依赖。

这种模型化的方式，后期API结构改动时，只需要修改对应的模型结构体，不用到处找拼接字符串的地方，维护成本大大降低，而且序列化的过程也不会出现手动拼接时的语法错误（比如漏写引号、逗号）。

内容的提问来源于stack exchange，提问作者jtrenton