api-design

3熱

1答えて

私はREST APIを構築しています。私はリンクを非常に長くしている関係があります。彼らは私には意味をなさないが、それは混乱している。私はこれを処理する最善の方法が何であるか分かりません。長い間リンクしているのは問題ですか？私はこれらの原則に違反していますか？このような関係をどのように扱うべきですか？以下の例は少し工夫されていますが、私が何をしようとしているかを示しています。会社は、部が多く、

1熱

1答えて

Rails APIでカスタムエラーコードを返すには？

Railsに実装されたRESTfulなAPIがあれば、私はActiveModel::Validationsによって生成されたエラーメッセージだけでなくカスタムエラーコードもレスポンスに含めたいと思います。まず、私はHTTP Status codesについて話していないことを指摘したいと思います。私は、record not foundのような一般的なエラーからusername can't be bl

0熱

2答えて

リソースはコレクション内で同じ構造でなければならない

GET /task/IDでリソースを表示し、コレクションGET /taskで行を表示すると、RESTのサブセットに関する質問が見つかりました。 REST - Resource and Collection Representations 私はApigilityを使用しています。 RESTは公式ではありませんが、全体的なベストプラクティス/標準でできる限り厳格に保持することを望みます。他のフィール

-1熱

1答えて

OpenGL - APIデザイン

私は新しいOpenGLベースのレンダリングエンジンに取り組んできましたが、次の問題に遭遇しました。glClear(); glUniformxx, ...のようなOpenGL機能を公開したいのですが、呼び出し前にOpenGLコンテキストを作成する必要がありますそれらの機能のいずれか。問題は、OpenGL はコンテキストを管理していないので、gl関数を呼び出す前に定義されていない動作（ほとんどの場合s

2熱

1答えて

jqueryで私のAPIを使用しているので、私のAPIが公開されないようにする方法はありますか？

私はpublicに私のアプリケーションのapi paths.butを知らせたくありません。私はjquery ajax urlのものを使ってバックエンドと対話しています。 $.ajax({ url: "test.html", type:'get' }).done(function() { //some function });

4熱

1答えて

Swagger UI - モデルのリストを単独で表示する方法

Swagger Editorの例では、http://editor.swagger.io/#/には、後でレンダリングされたドキュメントの「モデル」セクションが表示されます。これは、このエディタの機能だけで、あなたがそれらを定義する方法を見ているかどうかを確認するか、Swagger UIにすべてのモデルを表示することも可能ですか？（彼らはまた、特に定義されたが、協力者が来るのかを見ることができるよう

3熱

1答えて

残りのAPIリソース内の個々のユーザーデータを返すのは問題ありませんか？

たとえば、書籍の詳細をモバイルアプリケーションに渡すAPIを持っているとします。ユーザーは書籍のリストをブラウズし、希望リストに書籍を追加することができます。私の質問は、1つの本または書籍のコレクションを返すとき、各書籍リソースにユーザー固有の情報を含めることをお勧めしますか？これはつまり、各本には、その本がユーザーの希望リストにあるかどうかを示すフィールドを含めることができますか、このリストは

0熱

1答えて

aws apiボディマッピングテンプレート

aws apiから出力をフォーマットしようとしていますが、オブジェクトのリストの1つを取得できません。 I DynamoDBの中にロードされたデータを持っているし、私のデータは次のようになります。 [ { "lastname": "person1", "firstname": "last2", "employeeid": 7, "hrs": [

0熱

2答えて

APIで返される最も興味深い日付と時刻の形式

APIについては、の日付と時刻のように、私たちのAPIについての情報を送信したいと考えています。さまざまなプログラミング言語（PHP、Ruby、JavaScriptなど）で簡単に使用できるように、どのフォーマットをに返すことをお勧めしますか？私は2つの応答の考え：事前に { "published": "2016-06-30T14:45:16+0200", //ISO 8601

0熱

2答えて

REST - リソースのアドレス可能度（構成、コレクション）

私はREST-APIを設計していますが、現在次の質問が残っています。例えば /foods/fruits/{fruit} /foods/meat/{meat} ：たとえば、私は、次のstructrueを得た /foods/fruits/apple /foods/fruits/pinapple /foods/meat/chicken エンドポイントのそれぞれは、（only one app