`&`や`=`を含むURLを検索条件のパラメーターにするとAPI接続で値が取得できない

Question

前提・実現したいこと

SwiftUIで、API接続でデータを取得し利用するアプリを開発しています。

SwiftUIで開発中のアプリから、API接続でGETの方法でデータを取得する際に、検索条件のパラメーターが&や=を含むURLになる場合、データを取得することができません。

発生している問題

例えば、
http://sample.com/api/book/というベースのエンドポイントがあり、?url=というように、URLの文字列を検索の条件とする場合：

• ①：以下のようにパラメーターを設定すると値が取得できますが、

http://sample.com/api/book/?url=`https://nicebook.com/detail/id/106639`

• ②：以下の場合は取得できません

http://sample.com/api/book/?url=`https://nicebook.com/detail/?id=106639&category=history`

②の場合、パラメーターとして設定している文字列に?,=の記号が含まれ、こちらも検索の条件とされてしまい、期待している動きにならないと思うのですが、このような場合どのような対策方法があるでしょうか？

該当のソースコード

func fetchApiData() {

    let url_1 = "https://nicebook.com/detail/id/106639"
    let url_2 = "https://nicebook.com/detail/?id=106639&category=history"

    var endpoint = "http://sample.com/api/book/?url=" + url_1 // OK
    // var endpoint = "http://sample.com/api/book/?url=" + url_2 NG

    var encodeEndpoint = endpoint.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? ""

    // Set up the URL request
    guard let url = URL(string: encodeEndpoint) else {
        print("Error: cannot create URL")
        return
    }
    let urlRequest = URLRequest(url: URL)

    // set up the session
    let config = URLSessionConfiguration.default
    let session = URLSession(configuration: config)

    // make the request
    let task = session.dataTask(with: urlRequest) {
        (data, response, error) in

        // check for any errors
        guard error == nil else {
            print("error calling GET")
            return
        }
        // make sure we got data
        guard let responseData = data else {
            print("Error: did not receive data")
            return
        }

        // parse the result as JSON, since that's what the API provides
        DispatchQueue.main.async {
            do{ self.bookInfos = try JSONDecoder().decode([BookInfo].self, from: responseData)
                print(self.bookInfos as Any) // url_2で行うと値が取れない（コンソール -> []）
            }catch{
                print("Error: did not decode")
                return
            }
        }
    }
    task.resume()
}

試したこと

こちら、Swift で日本語を含む URL を扱うの記事を参考に、パラメーターとなるURLのエンコードを別にエンコードする方法も試しましたが、うまく取得できません。

let url_2 = "https://nicebook.com/detail/?id=106639&category=history"
url_2.addEndpoint.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed)!
var endpoint = "http://sample.com/api/book/?url=" + url_2

var encodeEndpoint = endpoint.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? ""

補足情報

Swift 5.0

Answer 1

こんな感じでしょうか。
参考: [Swift] パーセントエンコードを自作関数でやる必要は無かった - Qiita

func fetchApiData() {
    let url_1 = "https://nicebook.com/detail/id/106639"
    let url_2 = "https://nicebook.com/detail/?id=106639&category=history"

    let endpoint = "http://sample.com/api/book/"

    var urlComps = URLComponents(string: endpoint)!
    urlComps.queryItems = [URLQueryItem(name: "url", value: url_2)]
    guard let url = urlComps.url else {
        print("Error: cannot create URL")
        return
    }
    let urlRequest = URLRequest(url: url)

    // 略

ちなみに、パラメータに + が含まれる場合は要注意かもです。
参考: URLQueryItemの罠〜Base64とエンコードされない+〜 - Qiita

Comments

[tomaa]

情報ありがとうございます。
教えていただいた方法で試すと、期待通りにデータを取得する事ができました。
ありがとうございました！！