当前位置：首页 > news >正文

房天下平台API接口开发指南

news 来源：原创 2025/4/27 5:24:57

房源搜索接口（Python示例）
接口功能

通过城市、关键词、价格范围等条件筛选房源。

请求示例
python
Copy Code
import requests

url = "https://api.fang.com/property/search"
params = {
    "city": "北京",
    "keyword": "朝阳区",
    "min_price": 300,
    "max_price": 500,
    "page": 1,
    "page_size": 10
}
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)

响应示例
json
Copy Code
{
    "code": 200,
    "data": [
        {
            "id": "12345",
            "title": "朝阳区精装两居室",
            "price": 450,
            "area": "85㎡",
            "location": "朝阳区国贸"
        }
    ],
    "total": 100
}

2. 房源详情接口（JavaScript示例）
接口功能

根据房源ID获取详细信息，包括图片、描述、户型等。

请求示例
javascript
Copy Code
fetch('https://api.fang.com/property/detail', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        property_id: '12345'
    })
})
.then(response => response.json())
.then(data => console.log(data));

响应示例
json
Copy Code
{
    "code": 200,
    "data": {
        "id": "12345",
        "title": "朝阳区精装两居室",
        "price": 450,
        "images": ["url1", "url2"],
        "description": "南北通透，地铁沿线",
        "contact": "李经理 138&zwnj;****&zwnj;5678"
    }
}

3. 用户登录认证接口（Python示例）
接口功能

通过手机号或账号密码获取访问令牌。

请求示例
python
Copy Code
url = "https://api.fang.com/auth/login"
data = {
"username": "user@example.com",
"password": "your_password"
}
response = requests.post(url, json=data)
token = response.json().get("access_token")

响应示例
json
Copy Code
{
    "code": 200,
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expires_in": 3600
}

4. 常见错误码说明
401 Unauthorized: API密钥无效
404 Not Found: 房源不存在
500 Internal Error: 服务器内部错误
5. 最佳实践
保护API密钥‌：避免在客户端明文存储密钥。
分页查询‌：通过page和page_size参数优化大数据量请求。
异常处理‌：捕获HTTP 5xx错误并实现重试逻辑。