RESTful API エンドポイント (get)

getエンドポイントについて

単一オブジェクトを返します。ステータス付きモデルの場合認証付きリクエストで権限がない場合、非公開・無効なオブジェクトは取得できません。

エンドポイント(entryモデルの例)

/api/v1/スコープID/モデル名/get/オブジェクトID
/api/v1/スコープID/モデル名/get/プライマリカラムの値
/api/v1/スコープID/モデル名/get/?basename=オブジェクトのベースネーム
/api/v1/1/entry/get/1
/api/v1/1/entry/get/Welcome%20to%20our%20website%21
/api/v1/1/entry/get/?basename=powercmsx

メソッド

GET

パラメタ

?keys=返却するキー1,返却するキー2

レスポンス(成功時)

{
    "id": 1,
    "title": "Welcome!",
    "text": "<h2>Our Story<\/h2>\n<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.<\/p>\n<blockquote>\n<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.<\/p>\n<\/blockquote>",
    "text_format": "richtext",
    "assets": [
        {
            "id": 26,
            "label": "powercmsx",
            "file": {
                "Url": "https:\/\/localhost\/01\/assets\/powercmsx.png",
                "Label": null,
                "Metadata": {
                    "file_size": 76618,
                    "image_width": 600,
                    "image_height": 600,
                    "class": "image",
                    "extension": "png",
                    "mime_type": "image\/png",
                    "uploaded": "2021-09-02 15:11:58",
                    "user_id": 1
                }
            },
            "extra_path": "assets\/",
            "file_name": "powercmsx.png",
            "file_ext": "png",
            "mime_type": "image\/png",
            "tags": [],
            "size": 76618,
            "image_width": 600,
            "image_height": 600,
            "class": "image",
            "status": 4,
            "created_by": 1,
            "modified_by": 1,
            "created_on": "2021-09-02 15:11:58",
            "modified_on": "2021-09-02 15:11:58",
            "workspace_id": 1,
            "published_on": "2021-09-02 15:11:58",
            "rev_type": 0,
            "user_id": 1,
            "uuid": "a415ce51-5e70-4b1b-9413-8342f3e864ab",
            "Permalink": "https:\/\/localhost\/01\/assets\/powercmsx.png",
            "Thumbnail": "https:\/\/localhost\/powercmsx\/assets_c\/thumb-asset-128xauto-square-26-file.png"
        }
    ],
    "text_more": "",
    "excerpt": "Our StoryLorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
    "keywords": "",
    "categories": [
        {
            "id": 1,
            "label": "Press Release",
            "order": 1,
            "basename": "press_release",
            "workspace_id": 1,
            "created_on": "2021-08-27 15:13:45",
            "modified_on": "2021-08-27 15:13:45",
            "created_by": 1,
            "modified_by": 1,
            "Permalink": "https:\/\/localhost\/01\/press_release\/index.html",
            "Path": "press_release"
        }
    ],
    "tags": [
        {
            "id": 6,
            "name": "PowerCMS X",
            "normalize": "powercmsx",
            "class": "entry",
            "order": 2,
            "workspace_id": 1,
            "created_on": "2021-09-02 15:09:57",
            "modified_on": "2021-09-02 15:09:57",
            "created_by": 1,
            "modified_by": 1
        }
    ],
    "extra_path": "",
    "basename": "powercmsx",
    "status": 4,
    "has_deadline": 0,
    "published_on": "2021-09-01 12:47:46",
    "rev_note": "",
    "rev_diff": "",
    "rev_type": 0,
    "user_id": {
        "id": 1,
        "nickname": "Junnama Noda",
        "photo": "",
        "text_format": "",
        "space_order": "",
        "fix_spacebar": 1,
        "language": "ja",
        "control_border": "",
        "status": 2
    },
    "previous_owner": 0,
    "rev_changed": "",
    "allow_comment": 0,
    "created_on": "2021-08-27 15:13:45",
    "modified_on": "2021-09-02 15:12:06",
    "created_by": 1,
    "modified_by": 1,
    "workspace_id": 1,
    "rev_object_id": 0,
    "uuid": "d574478a-6762-434f-b002-723c835444ee",
    "Permalink": "https:\/\/localhost\/01\/press_release\/powercmsx.html"
}

レスポンス・エラー

共通レスポンスエラーについてはこちら を参照ください。

許可されないリクエストメソッド

{
    "status": 400,
    "message": "Method リクエストメソッド not allowed."
}

該当するオブジェクトが存在しない

{
    "status": 404,
    "message": "The モデル名 was not found."
}

認証付きリクエストでログイン中のユーザーがそのオブジェクトに対する権限がない

{
    "status": 403,
    "message": "Permission denied."
}