常連

現在、javaのルールをRESTをつかってJSON形式にしてnode.jsから呼び出すといった作業をしている過程で、SOAPとRESTについて違いが知りたくしらべているのですが、どのサイトを見てもいまいちピンと来るものがありません。



わかりやすい例などございましたらそれもふくめて教えていただけませんでしょうか？

SOAP とRESTの違いについてわかりやすく教えていただけませんでしょうか？

### 実現したいこと
私のサービスのポートを8080から80に変更してください。

### 発生している問題・分からないこと
8080から80にポートを変更しようとしましたが、うまくいかないようです…デバッグにはEchoAPIを使いましたが、うまくいきませんでした。Thunder ClientやPostmanも試しましたが、ダメでした。

![イメージ説明](https://ddjkaamml8q8x.cloudfront.net/questions/2024-10-29/e573ad6d-411e-45f1-a5dd-10d02dfe4a2f.png)

Did I not change it correctly, or am I using the tools wrong?

### エラーメッセージ
```error
action：
liutianyu@MacBook-Pro ~ % /Users/liutianyu/Downloads/frank
port=80
but:
Server is running on
0.0.0.0:8080
```

### 該当のソースコード

```
特になし
```

### 試したこと・調べたこと
- [x] teratailやGoogle等で検索した
- [ ] ソースコードを自分なりに変更した
- [ ] 知人に聞いた
- [ ] その他

##### 上記の詳細・結果
「port = 80」を試しましたが、調整時にはまだ8080が必要です。

### 補足
特になし

どうすればこのポートを8080から80に変更できるのか。変更したつもりだけど、うまくいかなかったようで、デバッグが成功しません。

### 実現したいこと
フロントエンドをVue、バックエンドをJavaでWebアプリを作成しています。
バックエンドでのAPIの実装のパターンで2つのケースを想定しているのですが、どちらが一般的な手法であるかを知りたいです。

### 発生している問題・分からないこと
複合的なデータが更新されるケースでのAPIの実装方法がわからないです。

例えば、販売管理システムを考えると、
お客様からの注文を受けた時点で営業担当が何らかのフォームにデータを入力することで、お客様の情報や注文情報などが顧客テーブルや注文テーブルにインサートされると思います。

1つのフォーム処理で複数のテーブルに更新が走るケースでの実装方法ですが、
①バックエンドのAPIをREST APIで実装していた場合、以下のようなURIになると思います。
/api/customer (顧客の新規作成)
/api/order (注文の新規作成)
このような場合、フロントエンドでは顧客のデータを更新するためのAPIをそれぞれ2回呼び出すのでしょうか？

②もしくは複合データモデルを作っておいて、
/api/orderreceive
のようなAPIを一度だけ呼び出したら、その中で顧客の新規作成も注文の新規作成も行われるような形でしょうか？

①だとフロント側の呼び出しが冗長になるのと、API呼び出しを繰り返すことでパフォーマンスに悪影響が出るのではと思っていて、
②だとバックエンドをREST APIで実装していた際に、RESTの原則に反する実装になってしまわないかと思っています。

私はWeb開発初心者のため、認識に間違いがあれば、指摘いただけますと幸いです。また、情報に不足があれば、可能な限り補足しますので、コメント頂けたらと思います。よろしくお願いします。



### 該当のソースコード

```
特になし
```

### 試したこと・調べたこと
- [x] teratailやGoogle等で検索した
- [ ] ソースコードを自分なりに変更した
- [ ] 知人に聞いた
- [x] その他

##### 上記の詳細・結果
書籍等もいくつか確認しましたが、初心者向けの書籍では求めている情報を見つけられませんでした。

### 補足
特になし

フロントエンドとバックエンドのデータをやりとりする際のAPI実装について

## テーマ、知りたいこと

下記経緯にも記述しましたが，PUT や DELETE メソッドを使わない API を設計する理由として，
form タグの method 属性が対応していないこと以外に理由はあるのでしょうか．

真偽はともかく，軽く調べたところだと「Web ブラウザが対応していない」や「セキュリティの問題がある」などの意見が散見されました．
前者については，少なくとも現在有力なブラウザは対応していると思うので，古いないしは限定的な理由なのかなと思います．
後者については PUT および DELETE に認証がないなどという記述が見られました．
(検索の仕方に問題があるのかもしれませんが) そのあたりについて具体的に述べている資料を見つけるに至りませんでした．
また WAF や Proxy で弾かれてしまうからと仰っている人もいましたが，それは結局のところ設定の問題だと思うので知りたい結論ではありませんでした．

改めて知りたいことを整理すると，
PUT および DELETE メソッドにあって，POST メソッドにはない(主にセキュリティの観点での)問題点とは具体的に何なのか
です．

## 経緯

API 設計において，PUT や DELETE を用いず GET および POST のみで設計する人が少なからずいます．
HTML form タグの method 属性が get および post しか対応していないことが由来なのだろうとは思っていましたが，それ以上の理由が存在するのか調べたのがきっかけです．


PUT DELETE のセキュリティ面での懸念について

![Insomnia API.png](https://assets.echoapi.com/upload/user/216769532487155712/log/8d668166-732d-4b65-bf75-10e00aba24bf.png "Insomnia API.png")

## Insomniaとは
Insomniaは、主に開発者やAPIエンジニア向けのクロスプラットフォームのデスクトップアプリです。高機能なHTTPクライアントであり、HTTPリクエストの作成、送信、レスポンスの確認を行うことができます。

![Insomniaとは.png](https://assets.echoapi.com/upload/user/216769532487155712/log/bb26188e-e04e-4464-a273-a720fd0d759b.png "Insomniaとは.png")

## Insomniaの機能
Insomniaは非常に有名なAPI管理ツールとして、以下の機能を備えています：

- **リクエスト作成と送信**: HTTPメソッド（GET、POST、PUT、DELETEなど）、URL、ヘッダー、パラメータ、ボディデータを設定し、APIリクエストを作成し送信できます。
- **レスポンスの確認**: サーバーからのレスポンスのステータス・コード、ヘッダー、ボディデータが表示され、解析やデバッグが行えます。
- **環境変数の管理**: 開発、ステージング、本番など異なる環境間で変数を管理し、APIリクエストの動的な値の使用・切り替えが簡単にできます。
- **リクエストのグループ化**: ワークスペース、フォルダ、グループなどの階層構造を使用し、複数のAPIリクエストを整備・管理できます。
- **複数の認証方式のサポート**: ベーシック認証、OAuth、Bearerトークンなど、さまざまな認証方式をサポートし、APIテスト・アクセスのセキュリティ保証が可能です。

## RESTful APIリクエストを送信する方法

![How to Send a RESTful API Request with Insomnia.png](https://assets.echoapi.com/upload/user/216769532487155712/log/d299fd1b-b541-463b-8218-4940bb412cb6.png "How to Send a RESTful API Request with Insomnia.png")

1. **Insomniaを開き**、**Debugタブ**に切り替え、**New Request**を選択します。
2.「HTTP Request」**を選択し、左側のパネルで**「New Request」**をダブルクリックしてリクエストの名前を設定します。
3. メソッドのドロップダウンメニューから通信方式（GET、POST、PUTなど）を選択します。
4. アドレスバーにAPIのエンドポイントのURLを入力します。
5. APIリクエストに認証トークンなどが必要な場合、「**Auth**」タブに切り替え、認証情報を記入します。
6.「Send」ボタンをクリックして、リクエストを送信し、レスポンスを取得します。

## リクエストに利用できるオプション
- **Body**: タブ上のBodyドロップダウンメニューからBodyタイプを選択し、リクエストのBodyに内容を追加します。
- **Auth**: タブ上のAuthドロップダウンメニューから認証のタイプを選択します。
- **Query**: クエリパラメータをリクエストURLに追加します。（例：`?page=1`）
- **Header**: リクエストにHeaderを追加します。（例：`Content-Type: application/json`）
- **Docs**: リクエストの説明文を追加します。

---

## EchoAPI：より優れた代替案
Insomniaは優れたツールですが、EchoAPIによってAPI開発のより優れた代替案が提供されています。EchoAPIはAPI設計、デバッグ、自動テスト、負荷テストをサポートする超軽量のコラボレーション・ツールです。IntelliJ IDEA、VS Code、Chrome向けのリクエストキャプチャ拡張機能のプラグインも提供しており、ログインの必要がないため、Postmanの完璧な代替品となります。

![EchoAPIを検討してみてください](https://assets.echoapi.com/upload/user/216769532487155712/log/4897deb0-5495-44f8-92c2-32a6175267a4.png "EchoAPIを検討してみてください")

EchoAPIは以下のような特徴を持っています：

- スクラッチパッドをサポートする超軽量なAPI開発ツール
- API設計、デバッグ、自動テスト、負荷テストなど機能の提供
- IntelliJ IDEA、VS Code用のプラグインとChromeリクエストキャプチャ拡張機能の搭載
- ログイン不要で利用可能



Insomniaの使い方：詳細ガイド

PHP初心者です。

現在、PHPでREST APIを作るべく、フレームワークを選定しているのですが、
ずばり、どのフレームワークが向いているでしょうか？

JAVAはJerseyをよく使っていましたが、
PHPでREST向けに標準化されていたりすることがあれば
そういったお話もご教授いただけるとありがたいです。

様々なアドバイスおまちしております。

PHPでREST APIを作るのに向いているフレームワークはなんでしょうか？

サーバー側でレスポンスをgzipなどで圧縮し、クライアント側でそれを展開することで通信容量を少なくし、コンテンツを取得する速度を速くすることも出来ますが、
一方で圧縮・展開に追加のリソースかかり、それが表示時間の増加に繋がってしまう恐れもあるかと思います。

一般的なプラクティスとして、jsonを返す一般的なRESTサーバー（TwitterやGithubのAPIなど）では、レスポンスは圧縮するべきなのでしょうか。

一般的なRESTサーバーは、jsonレスポンスをgzipなどで圧縮するべきでしょうか

例えば、以下のREST APIに、以下のようなリクエストボディを付けてリクエストを投げるとします。

```
[DELETE] http://httpbin.org/delete
・リクエストボディ:{"param" : "hello"}
```

以下のサンプルソースのような記述でリクエストを送ったところ、リクエストボディの内容がAPIに届く時点で空になってしまいます。

```javascript

// expressで作るサンプルAPIです
router.delete('/', (req, res, next) => {
  const http = require('http');
  const async = require('async');

  let options = {
    host : 'httpbin.org',
    port : 80,
    path : '/delete',
    method : 'DELETE',
    headers : {"Content-Type" : "application/json"}
  };

  // let options = {
  //   host : 'httpbin.org',
  //   port : 80,
  //   path : '/put',
  //   method : 'PUT',
  //   headers : ''
  // };

  let payload = JSON.stringify({"param" : "hello"});

  let req2;

 async.waterfall([
   function(callback) {
     req2 = http.request(options, (res2) => {
       let body = '';
       res2.on('data', (chunk) => {
         body += chunk;
       });
       res2.on('end', () => {
         callback(null, body);
       });
     });
     req2.write(payload); // リクエストボディをセット
     req2.end();
   },
   function(body,callback) {
     res.send(body); // リクエスト送信
     callback(null, body);
   }
 ],
 (e, result) => {
   if(e) {
     next(e);
     return;
   }
 });
});
```
レスポンスは以下になります。
dataの値にリクエストボディが入るはずですが、空になります。

```
{
  "args": {}, 
  "data": "", 
  "files": {}, 
  "form": {}, 
  "headers": {
    "Content-Type": "application/json", 
    "Host": "httpbin.org"
  }, 
  "json": null, 
  "origin": "１２３．４５６．７８９．０", 
  "url": "http://httpbin.org/delete"
}
```

これを、例えばPUTメソッドのリクエストに変えてみると、問題なくdataの値にリクエストボディが入ります。

なぜ、このような現象が起きるのか分かりません。
（DELETEメソッドの仕様？node.jsのバグ？）
御存知の方がいましたら、教えていただけないでしょうか。
よろしくお願いします。