房天下平台API接口开发指南
房源搜索接口(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‌****‌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错误并实现重试逻辑。
点击获取key和secret
总结
通过房天下提供的API,开发者可快速集成房源搜索、详情获取、用户系统等功能。实际开发中需参考官方文档以确保接口参数和认证方式与最新版本一致。
如需更完整的代码或特定功能(如房源发布、数据统计),可进一步补充需求!