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 | 認証が必要 |
406 | Acceptヘッダがありません。例: 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"
|