私には「APIfy」が必要なソフトウェアがあります。このソフトウェアはCOBOLで書かれ、メインフレームで実行され、エントリポイントは1つだけです。システムの目的は、リスクアセスメントを行うことで見込み顧客を評価することです。それは、いくつかの顧客情報(例えば、SSN、ファーストネームおよびファーストネーム)をパラメータとして取り上げ、いくつかの公的および民間企業に商業的背景を求め、リスクポリシーを実行し、意見を述べる。リソース上で動作しないアクションのRESTfulな設計上の回避策
このサービス用のRESTful APIを設計する方法はわかりません(アーキテクチャ上の要件であり、RPCサービスを作成できません)。私の最初の試みは、次のようなものでした:
POST mysoftwareapi/v0/evaluate
HTTP本体に顧客データを埋め込みました。しかし、RPCサービス(リソースなし、名詞の代わりの動詞)のような匂いがするので、私はそれを捨てました。それはもう少しRESTfulな見え
POST mysoftwareapi/v0/prospect
、その後
POST mysoftwareapi/v0/prospect/evaluate
または
GET mysoftwareapi/v0/prospect/evaluation
:
は、それから私は、2段階のAPIコールで出てきました。しかし、私は評価結果が得られ、意見が満足できる(顧客が見通しになる)前に、見通しを維持したくない。
この場合、どのようなRESTful APIデザインを使用しますか?