応答

Content-Typeヘッダ

全ての応答はJSON形式で返されます。これはContent-Typeヘッダにより示されます。

1
GET https://api.sendgrid.com/v3/resource HTTP/1.1
1
2
3
4
5
6
HTTP/1.1 200 OK
Content-Type: application/json

{
    "foo": "bar",
}

ステータスコード

以下に各リソースでサポートされているステータスコードを示します。

ステータスコード 説明
200正常
201作成成功
204削除成功
400要求内容が不正
401認証が必要
406Acceptヘッダがありません。例: Accept: applicatoin/json
429リクエスト数が多すぎます
500サーバ内部エラー

ページネーション

要求がページネーションクエリと共に要求を行った場合、以下のデータがヘッダに含まれます。 これにより、データセットの走査が簡単になります。

1
GET https://api.sendgrid.com/v3/resource?limit=5&offset=0 HTTP/1.1
1
2
3
4
5
6
7
HTTP/1.1 200 OK
Content-Type: application/json

Link: <http://api.sendgrid.com/v3/resource?limit=5&offset=5>; rel="next"; title="2",
      <http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="prev"; title="1",
      <http://api.sendgrid.com/v3/resource?limit=5&offset=10>; rel="last"; title="3",
      <http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="first"; title="1"