被リンクグループ
被リンクグループã®ãƒªã‚¹ãƒˆã‚’å–å¾—
ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€è¢«ãƒªãƒ³ã‚¯ã‚°ãƒ«ãƒ¼ãƒ—ã®ãƒªã‚¹ãƒˆã¨æ•°ã‚’å–å¾—ã™ã‚‹äº‹ãŒã§ãã¾ã™
リクエスト フォーマット
GET /backlink-groups/{site_id}
リクエスト パラメータ
| å称 | å¿…é ˆ | 説明 |
| site_id | Yes | ウェブサイト ID |
çµæžœ
æˆåŠŸã™ã‚‹ã¨ã€ã‚µãƒ¼ãƒãƒ¼ã¯è¢«ãƒªãƒ³ã‚¯ã‚°ãƒ«ãƒ¼ãƒ—ã®ãƒªã‚¹ãƒˆã¨æ•°ã‚’è¿”ã—ã¾ã™ã€‚
レスãƒãƒ³ã‚¹ä¾‹
{
"total_groups": 2,
"groups": [
{
"id": 1,
"name": "General",
"count": 5
},
{
"id": 2,
"name": "Second group",
"count": 1
}
]
}
レスãƒãƒ³ã‚¹ パラメータ
| å称 | 説明 |
| total_groups | åˆè¨ˆã‚°ãƒ«ãƒ¼ãƒ—æ•° |
| groups | グループã®é…列 |
| id | グループ ID |
| name | グループå |
| count | グループã®è¢«ãƒªãƒ³ã‚¯æ•° |
エラー
| HTTP コード | エラー メッセージ |
| 403 | アクセスãŒæ‹’å¦ã•ã‚Œã¾ã—㟠(wrong site_id) |
被リンクã®ã‚°ãƒ«ãƒ¼ãƒ—作æˆ
ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ã‚¦ã‚§ãƒ–サイト被リンクã®ã‚°ãƒ«ãƒ¼ãƒ—を作æˆã™ã‚‹äº‹ãŒã§ãã¾ã™ã€‚
リクエスト フォーマット
POST /backlink-groups/{site_id}
{
"name": "Group name"
}
リクエスト パラメータ
| å称 | å¿…é ˆ | 説明 |
| site_id | Yes | ウェブサイト ID |
| name | Yes | グループå |
çµæžœ
æˆåŠŸã™ã‚‹ã¨ã€ã‚µãƒ¼ãƒãƒ¼ã¯è¢«ãƒªãƒ³ã‚¯ã‚°ãƒ«ãƒ¼ãƒ—IDã‚’è¿”ã—ã¾ã™ã€‚
レスãƒãƒ³ã‚¹ä¾‹
レスãƒãƒ³ã‚¹ パラメータ
| å称 | 説明 |
| group_id | 被リンクグループ ID |
エラー
| HTTP コード | エラー メッセージ |
| 403 | アクセスãŒæ‹’å¦ã•ã‚Œã¾ã—㟠(wrong site_id) |
| 400 | 無効ãªå称 |
| 400 | グループã¯æ—¢ã«å˜åœ¨ã—ã¾ã™ |
被リンクグループã®å‰Šé™¤
ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ã‚¦ã‚§ãƒ–サイト被リンクã®ã‚°ãƒ«ãƒ¼ãƒ—を削除ã™ã‚‹äº‹ãŒã§ãã¾ã™ã€‚
リクエスト フォーマット
DELETE /backlink-groups/{site_id}?id={id}
リクエスト パラメータ
| å称 | å¿…é ˆ | 説明 |
| site_id | Yes | ウェブサイト ID |
| id | Yes | 被リンクグループ ID |
çµæžœ
æˆåŠŸã™ã‚‹ã¨ã€ã‚µãƒ¼ãƒãƒ¼ã¯204 HTTPコードを返ã—ã¾ã™ã€‚
エラー
| HTTP コード | エラー メッセージ |
| 403 | アクセスãŒæ‹’å¦ã•ã‚Œã¾ã—㟠(wrong site_id) |
| 400 | 無効ãªã‚°ãƒ«ãƒ¼ãƒ—ID |
| 400 | グループã¯å˜åœ¨ã—ã¾ã›ã‚“ |
被リンクグループã®åå‰å¤‰æ›´
ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯è¢«ãƒªãƒ³ã‚¯ã‚°ãƒ«ãƒ¼ãƒ—ã®å称を変更ã™ã‚‹äº‹ãŒã§ãã¾ã™ã€‚
リクエスト フォーマット
PUT /backlink-groups/{site_id}
{
"id": 2,
"name": "New group name"
}
リクエスト パラメータ
| å称 | å¿…é ˆ | 説明 |
| site_id | Yes | ウェブサイト ID |
| id | Yes | 被リンクグループ ID |
| name | Yes | æ–°ã—ã„被リンクグループå |
çµæžœ
æˆåŠŸã™ã‚‹ã¨ã€ã‚µãƒ¼ãƒãƒ¼ã¯204 HTTPコードを返ã—ã¾ã™ã€‚
エラー
| HTTP コード | エラー メッセージ |
| 403 | アクセスãŒæ‹’å¦ã•ã‚Œã¾ã—㟠(wrong site_id) |
| 400 | 無効ãªå称 |
| 400 | グループã¯æ—¢ã«å˜åœ¨ã—ã¾ã™ |
被リンクを別ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«ç§»å‹•
ã“ã®ãƒ¡ã‚½ãƒƒãƒ‰ã¯ã€ã‚るグループã‹ã‚‰è¢«ãƒªãƒ³ã‚¯ã‚’別ã®ã‚°ãƒ«ãƒ¼ãƒ—ã«ç§»ã™äº‹ãŒã§ãã¾ã™ã€‚
リクエスト フォーマット
POST /backlink-groups/{site_id}/move
{
"id": 1,
"backlink_ids": [1],
"group_ids": [2]
}
リクエスト パラメータ
| å称 | å¿…é ˆ | 説明 |
| site_id | Yes | ウェブサイト ID |
| id | Yes | 移動先ã®è¢«ãƒªãƒ³ã‚¯ã‚°ãƒ«ãƒ¼ãƒ— ID |
| backlink_ids | No | 移動ã•ã‚Œã‚‹è¢«ãƒªãƒ³ã‚¯ ID ã®é…列 |
| group_ids | No | 移動ã•ã‚Œã‚‹è¢«ãƒªãƒ³ã‚¯ã‚°ãƒ«ãƒ¼ãƒ— ID ã®é…列 |
çµæžœ
æˆåŠŸã™ã‚‹ã¨ã€ã‚µãƒ¼ãƒãƒ¼ã¯204 HTTPコードを返ã—ã¾ã™ã€‚
エラー
| HTTP コード | エラー メッセージ |
| 403 | アクセスãŒæ‹’å¦ã•ã‚Œã¾ã—㟠(wrong site_id) |
| 400 | 無効ãªã‚°ãƒ«ãƒ¼ãƒ—ID |
| 400 | 被リンクグループID |
| 400 | グループIDã¾ãŸã¯è¢«ãƒªãƒ³ã‚¯ã¯å¿…é ˆã§ã™ |
