リクエストの送信
ユーザーとグループ用のREST APIを使用してリクエストを送信する場合は、次のガイドラインを使用してください。
URLの構造
次のURL構造を使用して、ユーザーおよびグループのRESTリソースにアクセスします:
https://oracleContentInstance-identityName.network.dataCenter.oraclecloud.com/osn/social/api/v1/resource-path
説明:
-
oracleContentInstance - Oracle Content Management Cloudインスタンスのプロビジョニング時に選択した名前。
-
identityName - Oracle Public Cloudへのサインアップ時に使用したアイデンティティ名。
-
network - ネットワークの名前。
-
dataCenter - Oracle Content Management Cloudを使用するように設定されているデータ・センター。
-
resource-path - リソースを定義する相対パス。
サポートされるメソッド
次の表に示すように、標準のHTTPメソッド・リクエストを使用して、リソースに対して基本的なCRUD操作(作成、読み取り、更新、および削除)を実行できます。
| HTTPメソッド | 説明 |
GET |
ユーザー、グループ、1対1の会話、フォロワ、画像、またはガジェットなどのリソースに関する情報を取得します。 |
POST |
リソースの作成や、リソースに対する追加、LIKEの設定、星の付加を行います。または、リソースにフィールドやプロパティを設定します。 |
PUT |
リソースの更新またはマーク、あるいは、リソースのフォローアップのマークを行います。 |
DELETE |
リソースを削除したり、リソースの外観が気に入ったりスターになったり、リソースのフォローアップやフォローアップを閉じたり、接続を切断したり、メンバー、プロパティ、プロパティ、またはフィールドをリソースから削除します。 |
メディア・タイプ
ユーザーおよびグループ用のREST APIは、次のメディア・タイプをサポートしています:
-
application/json
サポートされているヘッダー
ユーザーおよびグループ用のREST APIは、次のヘッダーをサポートしています。これらのヘッダーは、HTTPリクエストまたはレスポンスのヘッダー・セクションに渡すことができます。
| ヘッダー | 説明 | 例 |
Accept-Encoding |
圧縮をサポートする受入可能なエンコーディングのリスト。 | Accept-Encoding: gzip |
Content-Encoding |
圧縮をサポートする受入可能なエンコーディングのリスト。 | Content-Encoding: deflate |
Content-Type |
リクエストの本体のメディア・タイプ。 POSTおよびPUTリクエストで必要です。 | Content-Type: application/json |
圧縮
改善されたパフォーマンスのために、ユーザーとグループのリソース・リクエストとレスポンスに対するREST APIで圧縮を使用します。 圧縮を使用するには、リクエストにAccept-EncodingまたはContent-EncodingのHTTPヘッダーのいずれか1つを含めます。