1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2024-12-23 02:06:12 +02:00
OpenIntegrations/docs/en/md/Bitrix24/Feed-posts-managment/Get-posts.md
2024-07-10 14:33:00 +03:00

421 lines
9.3 KiB
Markdown

---
sidebar_position: 5
---
# Get posts
Gen post or array of post with ID or rights selection
`Function GetPosts(Val URL, Val PostID = "", Val Filter = "UA", Val Token = "") Export`
| Parameter | CLI option | Type | Destination |
|-|-|-|-|
| URL | --url | String | URL of webhook or a Bitrix24 domain, when token used |
| PostID | --postid | String, Number | Id of important post |
| Filter | --sel | String | Post selection by rights: UA all, SGn work group, Un user, DRn depart, Gn group |
| Token | --token | String | Access token, when not-webhook method used |
Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API
<br/>
:::tip
Method at API documentation: [log.blogpost.get](https://dev.1c-bitrix.ru/rest_help/log/log_blogpost_get.php)
:::
<br/>
```bsl title="Code example"
PostID = "124";
URL = "https://b24-ar17wx.bitrix24.by/rest/1/4swokunb3tk7h7dt/";
Result = OPI_Bitrix24.GetPosts(URL, PostID);
URL = "b24-ar17wx.bitrix24.by";
Token = "b9df7366006e9f06006b12e400000001000...";
Result = OPI_Bitrix24.GetPosts(URL, PostID,, Token);
```
```sh title="CLI command example"
oint bitrix24 GetPosts --url "b24-ar17wx.bitrix24.by" --postid "124" --sel %sel% --token "b9df7366006e9f06006b12e400000001000..."
```
```json title="Result"
{
"result": [
{
"ID": "40",
"BLOG_ID": "1",
"PUBLISH_STATUS": "P",
"TITLE": "Post title",
"AUTHOR_ID": "1",
"ENABLE_COMMENTS": "Y",
"NUM_COMMENTS": "0",
"CODE": null,
"MICRO": "N",
"DETAIL_TEXT": "Text of post",
"DATE_PUBLISH": "2024-06-13T18:41:47+00:00",
"CATEGORY_ID": null,
"HAS_SOCNET_ALL": "N",
"HAS_TAGS": "N",
"HAS_IMAGES": "N",
"HAS_PROPS": "Y",
"HAS_COMMENT_IMAGES": null,
"UF_BLOG_POST_DOC": {
"ID": "1",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_BLOG_POST_DOC",
"USER_TYPE_ID": "file",
"XML_ID": "UF_BLOG_POST_DOC",
"SORT": "100",
"MULTIPLE": "Y",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "N",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "Y",
"SETTINGS": {
"SIZE": 20,
"LIST_WIDTH": 0,
"LIST_HEIGHT": 0,
"MAX_SHOW_SIZE": 0,
"MAX_ALLOWED_SIZE": 0,
"EXTENSIONS": [],
"TARGET_BLANK": "Y"
},
"EDIT_FORM_LABEL": null,
"LIST_COLUMN_LABEL": null,
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "file",
"CLASS_NAME": "Bitrix\\Main\\UserField\\Types\\FileType",
"EDIT_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\FileType",
"renderEdit"
],
"VIEW_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\FileType",
"renderView"
],
"USE_FIELD_COMPONENT": true,
"DESCRIPTION": "File",
"BASE_TYPE": "file"
},
"VALUE": false,
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"UF_BLOG_POST_URL_PRV": {
"ID": "5",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_BLOG_POST_URL_PRV",
"USER_TYPE_ID": "url_preview",
"XML_ID": "UF_BLOG_POST_URL_PRV",
"SORT": "100",
"MULTIPLE": "N",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "N",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "Y",
"SETTINGS": [],
"EDIT_FORM_LABEL": null,
"LIST_COLUMN_LABEL": null,
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "url_preview",
"CLASS_NAME": "Bitrix\\Main\\UrlPreview\\UrlPreviewUserType",
"DESCRIPTION": "Link data",
"BASE_TYPE": "int"
},
"VALUE": null,
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"UF_GRATITUDE": {
"ID": "9",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_GRATITUDE",
"USER_TYPE_ID": "integer",
"XML_ID": "UF_GRATITUDE",
"SORT": "100",
"MULTIPLE": "N",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "N",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "N",
"SETTINGS": {
"SIZE": 20,
"MIN_VALUE": 0,
"MAX_VALUE": 0,
"DEFAULT_VALUE": null
},
"EDIT_FORM_LABEL": null,
"LIST_COLUMN_LABEL": null,
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "integer",
"CLASS_NAME": "Bitrix\\Main\\UserField\\Types\\IntegerType",
"EDIT_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\IntegerType",
"renderEdit"
],
"VIEW_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\IntegerType",
"renderView"
],
"USE_FIELD_COMPONENT": true,
"DESCRIPTION": "Whole number",
"BASE_TYPE": "int"
},
"VALUE": null,
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"UF_BLOG_POST_FILE": {
"ID": "19",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_BLOG_POST_FILE",
"USER_TYPE_ID": "disk_file",
"XML_ID": "UF_BLOG_POST_FILE",
"SORT": "100",
"MULTIPLE": "Y",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "N",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "Y",
"SETTINGS": {
"IBLOCK_ID": null,
"SECTION_ID": null,
"UF_TO_SAVE_ALLOW_EDIT": false
},
"EDIT_FORM_LABEL": null,
"LIST_COLUMN_LABEL": null,
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "disk_file",
"CLASS_NAME": "Bitrix\\Disk\\Uf\\FileUserType",
"DESCRIPTION": "File (Drive)",
"BASE_TYPE": "int",
"TAG": [
"DISK FILE ID",
"DOCUMENT ID"
]
},
"VALUE": [
74,
76
],
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": {
"PHOTO_TEMPLATE": ""
}
},
"UF_MAIL_MESSAGE": {
"ID": "75",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_MAIL_MESSAGE",
"USER_TYPE_ID": "mail_message",
"XML_ID": "",
"SORT": "100",
"MULTIPLE": "N",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "N",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "N",
"SETTINGS": null,
"EDIT_FORM_LABEL": null,
"LIST_COLUMN_LABEL": null,
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "mail_message",
"CLASS_NAME": "Bitrix\\Mail\\MessageUserType",
"DESCRIPTION": "Letter (email)",
"BASE_TYPE": "int",
"VIEW_CALLBACK": [
"Bitrix\\Mail\\MessageUserType",
"getPublicView"
],
"EDIT_CALLBACK": [
"Bitrix\\Mail\\MessageUserType",
"getPublicEdit"
],
"onBeforeSave": [
"Bitrix\\Mail\\MessageUserType",
"onBeforeSave"
],
"onDelete": [
"Bitrix\\Mail\\MessageUserType",
"onDelete"
]
},
"VALUE": null,
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"UF_BLOG_POST_IMPRTNT": {
"ID": "93",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_BLOG_POST_IMPRTNT",
"USER_TYPE_ID": "integer",
"XML_ID": "UF_BLOG_POST_IMPRTNT",
"SORT": "100",
"MULTIPLE": "N",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "Y",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "N",
"SETTINGS": {
"SIZE": 20,
"MIN_VALUE": 0,
"MAX_VALUE": 0,
"DEFAULT_VALUE": null
},
"EDIT_FORM_LABEL": "Important message",
"LIST_COLUMN_LABEL": "Important",
"LIST_FILTER_LABEL": "Important",
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "integer",
"CLASS_NAME": "Bitrix\\Main\\UserField\\Types\\IntegerType",
"EDIT_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\IntegerType",
"renderEdit"
],
"VIEW_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\IntegerType",
"renderView"
],
"USE_FIELD_COMPONENT": true,
"DESCRIPTION": "Whole number",
"BASE_TYPE": "int"
},
"VALUE": null,
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"UF_IMPRTANT_DATE_END": {
"ID": "95",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_IMPRTANT_DATE_END",
"USER_TYPE_ID": "datetime",
"XML_ID": "UF_IMPRTANT_DATE_END",
"SORT": "100",
"MULTIPLE": "N",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "N",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "N",
"SETTINGS": {
"DEFAULT_VALUE": {
"TYPE": "NONE",
"VALUE": ""
},
"USE_SECOND": "Y",
"USE_TIMEZONE": "N"
},
"EDIT_FORM_LABEL": "Expiration date",
"LIST_COLUMN_LABEL": "Deadline",
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "datetime",
"CLASS_NAME": "Bitrix\\Main\\UserField\\Types\\DateTimeType",
"EDIT_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\DateTimeType",
"renderEdit"
],
"VIEW_CALLBACK": [
"Bitrix\\Main\\UserField\\Types\\DateTimeType",
"renderView"
],
"USE_FIELD_COMPONENT": true,
"DESCRIPTION": "Date with time",
"BASE_TYPE": "datetime"
},
"VALUE": "",
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"UF_BLOG_POST_VOTE": {
"ID": "143",
"ENTITY_ID": "BLOG_POST",
"FIELD_NAME": "UF_BLOG_POST_VOTE",
"USER_TYPE_ID": "vote",
"XML_ID": "UF_BLOG_POST_VOTE",
"SORT": "100",
"MULTIPLE": "N",
"MANDATORY": "N",
"SHOW_FILTER": "N",
"SHOW_IN_LIST": "Y",
"EDIT_IN_LIST": "Y",
"IS_SEARCHABLE": "N",
"SETTINGS": {
"CHANNEL_ID": 1,
"UNIQUE": 8,
"UNIQUE_IP_DELAY": {
"DELAY": "10",
"DELAY_TYPE": "D"
},
"NOTIFY": "I"
},
"EDIT_FORM_LABEL": null,
"LIST_COLUMN_LABEL": null,
"LIST_FILTER_LABEL": null,
"ERROR_MESSAGE": null,
"HELP_MESSAGE": null,
"USER_TYPE": {
"USER_TYPE_ID": "vote",
"CLASS_NAME": "Bitrix\\Vote\\Uf\\VoteUserType",
"DESCRIPTION": "Poll",
"BASE_TYPE": "int"
},
"VALUE": null,
"ENTITY_VALUE_ID": 40,
"CUSTOM_DATA": []
},
"FILES": [
74,
76
]
}
],
"total": 1,
"time": {
"start": 1718304110.82197,
"finish": 1718304110.86041,
"duration": 0.0384387969970703,
"processing": 0.0108139514923096,
"date_start": "2024-06-13T18:41:50+00:00",
"date_finish": "2024-06-13T18:41:50+00:00",
"operating_reset_at": 1718304710,
"operating": 0
}
}
```