1

注:ドメイン可用性Webサービスを探していません!今、私たちはそれを邪魔にならないようにしました...

REST APIを介してドメインポートフォリオからリソースを取得し、同じAPIでドメインの可用性チェックを実行できるシステムをどのように設計しますか?両方の場合に同じURIを使用することをお勧めしますか、それともこれに別のリソースを使用する必要がありますか?

例えば:

example.com(ポートフォリオのドメイン)に関する情報が必要な場合は、そのGET /domains/example.com/情報(ネームサーバー、連絡先などの登録情報だけでなく、クライアントレコード、請求書番号などの内部情報も取得します)を取得します。 ...)。

たとえば、example.org(ポートフォリオに登録されていないため登録されていない)のドメインの可用性を取得したい場合はGET /domains/example.org/、ドメインが利用可能かどうかを返す呼び出しも行います。

つまり、これら2つのものに同じURIを使用するのは良い考えですか(基本的に両方ともドメインの情報を返しますか?)、またはこれに別のリソースを使用する必要がありますか?/domainregistration/example.com/例えば?

4

1 に答える 1

1

REST APIの基本的な考え方は、実装の詳細と、場合によってはドメイン情報のロジックの抽象化を提供することです。この観点では、ポートフォリオ内のドメインとポートフォリオ内にないドメインからドメイン情報を取得するため、抽象化が適切である可能性があります。

ただし、ドメイン情報の取得にはいくつかの違いもあります。たとえば、ポートフォリオに含まれていないドメインに関するドメイン情報の取得は、ポートフォリオ内のドメインの情報の取得よりも遅いか、少なくとも遅くなります。もう1つの違いは、REST APIの場合、複数のリソース情報を取得するためのいくつかのバルク機能がこのように提供されることが多いことGET /domains/example.com,anotherexample.com,localhost.com/です。ポートフォリオに含まれていないドメインに関する情報を取得するときに、このような機能にアクセスできないようにする必要があります。

リソースを分割するもう1つの理由は、ポートフォリオ内のドメインに関するすべての情報を取得する呼び出しを実装できることです。

GET /domains/

このリクエストは明らかにポートフォリオ内のドメインに関する情報しか返さない可能性があるため、その場合は抽象化が機能しなくなります。

ドメインの可用性を取得するためにRESTAPIをモデル化する場合、次のようなリソースを使用することをお勧めします

PUT /availabilities/example.com

ドメインの可用性チェックを作成します。example.comこのリソースは、この可用性チェックに関する情報を取得するために使用したり、次の方法でドメインの可用性チェックの結果をキャッシュしたりするために使用できるサブリソースを作成できます。

GET /availabilities/example.com

これらすべての議論をまとめると、リソースを分割することをお勧めします。理由は次のとおりです。

  • APIユーザーがポートフォリオ内のドメインの詳細なドメイン情報に関心がある場合、APIユーザーは/domainsリソースを確認できます
  • ドメインがポートフォリオに含まれている場合に情報を取得するには、ユーザーは/domains/example.comリソースも使用します
  • ドメインの可用性チェックのみに関心のあるAPIユーザーは、availabilitiesリソースを使用してこのチェックを実行できます。
于 2013-02-20T15:53:11.753 に答える