# Obtain Job Post Details of Referral Official Website

Obtain Job Post Details of Referral Official Website by Post ID.

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/hire/v1/referral_websites/job_posts/:job_post_id
HTTP Method | GET
Rate Limit | [1000 per minute、50 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | 获取内推官网信息(hire:referral_website:readonly)
Required field scopes | **Notice**：The response body of the API contains the following sensitive fields, and they will be returned only after corresponding scopes are added. If you do not need the fields, it is not recommended that you request the scopes.<br>Obtain user ID(contact:user.employee_id:readonly)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### Path parameters

Parameter | Type | Description
---|---|---
job_post_id | string | Job Advertising ID<br>**Example value**: "6701528341100366094"

### Query parameters

Parameter | Type | Required | Description
---|---|---|---
user_id_type | string | No | User ID categories<br>**Example value**: open_id<br>**Optional values are**:<br>- open_id：Identifies a user to an app. The same user has different Open IDs in different apps. [How to get Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)<br>- union_id：Identifies a user to a tenant that acts as a developer. A user has the same Union ID in apps developed by the same developer, and has different Union IDs in apps developed by different developers. A developer can use Union ID to link the same user's identities in multiple apps.[How to get Union ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)<br>- user_id：Identifies a user to a tenant. The same user has different User IDs in different tenants. In one single tenant, a user has the same User ID in all apps （including store apps）. User ID is usually used to communicate user data between different apps. [How to get User ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)<br>**Default value**: `open_id`<br>**When the value is `user_id`, the following field scopes are required**:<br>Obtain user ID(contact:user.employee_id:readonly)
department_id_type | string | No | The type of department ID used in this call<br>**Example value**: open_department_id<br>**Optional values are**:<br>- open_department_id：Identify departments by open_department_id<br>- department_id：Identify departments by department_id<br>**Default value**: `open_department_id`
job_level_id_type | string | No | The type of "Job Level ID" used in this request<br>**Example value**: 6942778198054125570<br>**Optional values are**:<br>- people_admin_job_level_id：The Job Level ID applicable to "HCM Platform". The HCM Platform is gradually being offline. It is recommended not to continue using this ID type.<br>- job_level_id：The Job Level ID applicable to "Feishu Management Backend" can be obtained through the [Query the list of job level](https://open.feishu.cn/document/server-docs/contact-v3/job_level/list) interface.<br>**Default value**: `people_admin_job_level_id`

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
job_post | portal_job_post | Job Advertising Information
id | string | Job Advertising ID
title | string | Title
job_id | string | Job ID
job_code | string | Job Code
job_expire_time | string | Job expiration time, "null" means "long-term validity"
job_active_status | int | Job Status<br>**Optional values are**:<br>- 1：Enabled State<br>- 2：Disabled State
job_process_type | int | Job Process Type<br>**Optional values are**:<br>- 1：Social Recruitment<br>- 2：Campus Recruitment
job_recruitment_type | id_name_object | Position Employment Type
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
job_department | id_name_object | Position Department
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
job_type | id_name_object | Job Type
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
min_job_level | id_name_object | min job level
id | string | job level ID
name | i18n | job level name
zh_cn | string | job level Chinese name
en_us | string | job level English name
max_job_level | id_name_object | max job level
id | string | job level ID
name | i18n | job level name
zh_cn | string | job level Chinese name
en_us | string | job level English name
address | common_address | Job Address
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
district | code_name_object | Regional Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
city | code_name_object | City Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
state | code_name_object | Provincial Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
country | code_name_object | Country Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
min_salary | string | Monthly Salary Range - Minimum Salary
max_salary | string | Monthly Salary Range - Maximum Salary
required_degree | int | Academic requirements<br>**Optional values are**:<br>- 1：Primary school and above<br>- 2：Junior high school and above<br>- 3：Full-time and above<br>- 4：High school and above<br>- 5：College and above<br>- 6：Bachelor degree and above<br>- 7：Master and above<br>- 8：Doctor and above<br>- 20：Unlimited
experience | int | Experience<br>**Optional values are**:<br>- 1：Unlimited<br>- 2：Fresh graduate<br>- 3：Less than 1 year<br>- 4：1-3 years<br>- 5：3-5 years<br>- 6：5-7 years<br>- 7：7-10 years<br>- 8：More than 10 years
headcount | int | Quantity
high_light_list | id_name_object\[\] | Job Highlights
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
description | string | Job Description
requirement | string | Job Requirements
creator | id_name_object | Founder
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
create_time | string | Creation Time
modify_time | string | Modification Time
customized_data_list | website_job_post_customized_data\[\] | Custom Fields
object_id | string | Custom field ID
name | i18n | Field Name
zh_cn | string | Chinese
en_us | string | English
object_type | int | Field Type<br>**Optional values are**:<br>- 1：One-line Text<br>- 2：Multi-line Text<br>- 3：Radio<br>- 4：Multiple Choice<br>- 5：Date<br>- 6：Month Selection<br>- 7：Year Selection<br>- 8：Time Period<br>- 9：Numbers<br>- 10：Default field
value | website_job_post_customized_value | Custom field values
content | string | When the field type is single-line text, multi-line text, module, default field, take the value from this field
option | website_job_post_customized_option | When the field type is radio, take the value from this field
key | string | Option ID
name | i18n | Option Name
zh_cn | string | Chinese
en_us | string | English
option_list | website_job_post_customized_option\[\] | When the field type is multi-select, take the value from this field
key | string | Option ID
name | i18n | Option Name
zh_cn | string | Chinese
en_us | string | English
time_range | website_job_post_customized_time_range | When the field type is time period, take the value from this field
start_time | string | Start Time
end_time | string | End Time
time | string | When the field type is date selection, month selection, year selection, take the value from this field, which is a millisecond timestamp
number | string | When the field type is a number, take the value from this field
job_function | id_name_object | Functional Classification
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
subject | id_name_object | Job Items
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
address_list | common_address\[\] | Job Advertising Address List
id | string | ID
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
district | code_name_object | Regional Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
city | code_name_object | City Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
state | code_name_object | Provincial Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English
country | code_name_object | Country Information
code | string | Coding
name | i18n | Name
zh_cn | string | Chinese
en_us | string | English

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "job_post": {
            "id": "1213213123123",
            "title": "测试",
            "job_id": "xxx",
            "job_code": "007",
            "job_expire_time": "1111",
            "job_active_status": 1,
            "job_process_type": 1,
            "job_recruitment_type": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            },
            "job_department": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            },
            "job_type": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            },
            "min_job_level": {
                "id": "6890840777044265230",
                "name": {
                    "zh_cn": "级别-2",
                    "en_us": "level-2"
                }
            },
            "max_job_level": {
                "id": "6890840777044265230",
                "name": {
                    "zh_cn": "级别-2",
                    "en_us": "level-2"
                }
            },
            "address": {
                "id": "6583482347283472832",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                },
                "district": {
                    "code": "1111",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "city": {
                    "code": "1111",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "state": {
                    "code": "1111",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                },
                "country": {
                    "code": "1111",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                }
            },
            "min_salary": "5000",
            "max_salary": "10000",
            "required_degree": 1,
            "experience": 1,
            "headcount": 12,
            "high_light_list": [
                {
                    "id": "1213213123123",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    }
                }
            ],
            "description": "负责软件开发",
            "requirement": "大专",
            "creator": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            },
            "create_time": "1111",
            "modify_time": "222",
            "customized_data_list": [
                {
                    "object_id": "xxxx",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    },
                    "object_type": 1,
                    "value": {
                        "content": "text",
                        "option": {
                            "key": "AA",
                            "name": {
                                "zh_cn": "测试",
                                "en_us": "test"
                            }
                        },
                        "option_list": [
                            {
                                "key": "AA",
                                "name": {
                                    "zh_cn": "测试",
                                    "en_us": "test"
                                }
                            }
                        ],
                        "time_range": {
                            "start_time": "AA",
                            "end_time": "AA"
                        },
                        "time": "1625456721000",
                        "number": "111"
                    }
                }
            ],
            "job_function": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            },
            "subject": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "测试",
                    "en_us": "test"
                }
            },
            "address_list": [
                {
                    "id": "6583482347283472832",
                    "name": {
                        "zh_cn": "测试",
                        "en_us": "test"
                    },
                    "district": {
                        "code": "1111",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    },
                    "city": {
                        "code": "1111",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    },
                    "state": {
                        "code": "1111",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    },
                    "country": {
                        "code": "1111",
                        "name": {
                            "zh_cn": "测试",
                            "en_us": "test"
                        }
                    }
                }
            ]
        }
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
500 | 1002001 | System error | Check if the imported parameters are valid
400 | 1002002 | Parameter illegal | Check that the imported parameter format is correct
404 | 1002509 | The job hasn't been posted to this website | Check if the parameters are correct

