Merge pull request #30 from cybozu/fetch-record

Added fetchRecord API

Author: Kyome22

README.md

@@ -28,6 +28,7 @@ Providing kintone REST API with Swift interface.
 | `fetchAppStatusSettings` | GET    | [/k/v1/app/status.json](https://kintone.dev/en/docs/kintone/rest-api/apps/get-process-management-settings/) |
 | `fetchRecords`           | GET    | [/k/v1/records.json](https://kintone.dev/en/docs/kintone/rest-api/records/get-records/)                     |
 | `removeRecords`          | DELETE | [/k/v1/records.json](https://kintone.dev/en/docs/kintone/rest-api/records/delete-records/)                  |
+| `fetchRecord`            | GET    | [/k/v1/record.json](https://kintone.dev/en/docs/kintone/rest-api/records/get-record/)                       |
 | `submitRecord`           | POST   | [/k/v1/record.json](https://kintone.dev/en/docs/kintone/rest-api/records/add-record/)                       |
 | `updateRecord`           | PUT    | [/k/v1/record.json](https://kintone.dev/en/docs/kintone/rest-api/records/update-record/)                    |
 | `fetchRecordComments`    | GET    | [/k/v1/record/comments.json](https://kintone.dev/en/docs/kintone/rest-api/records/get-comments/)            |

Sources/KintoneAPI/Decodable/FetchRecordResponse.swift

@@ -0,0 +1,23 @@
+//
+//  FetchRecordResponse.swift
+//
+//
+//  Created by ky0me22 on 2025/02/28.
+//
+
+public struct FetchRecordResponse: Decodable, Sendable, Equatable {
+    public var record: Record.Read
+
+    enum CodingKeys: CodingKey {
+        case record
+    }
+
+    public init(from decoder: any Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        record = try container.decode(Record.Read.self, forKey: .record)
+    }
+
+    init(record: Record.Read) {
+        self.record = record
+    }
+}

Sources/KintoneAPI/KintoneAPI.swift

@@ -155,6 +155,23 @@ public struct KintoneAPI: Sendable {
         try check(response: response)
     }
 
+    public func fetchRecord(
+        appID: Int,
+        recordID: Int
+    ) async throws -> FetchRecordResponse {
+        let queryItems = [
+            URLQueryItem(name: "app", value: appID.description),
+            URLQueryItem(name: "id", value: recordID.description),
+        ]
+        let request = makeRequest(httpMethod: .get, endpoint: .record, queryItems: queryItems)
+        let (data, response) = try await dataRequestHandler(request)
+        try check(response: response)
+        if let str = String(data: data, encoding: .utf8) {
+            print(str)
+        }
+        return try JSONDecoder().decode(FetchRecordResponse.self, from: data)
+    }
+
     @discardableResult
     public func submitRecord(
         appID: Int,