携程获取景点详情 API接口（携程开放平台合作）

携程提供了获取景点详情的API接口，具体如下：

公共参数

请求地址：​​前往测试​​

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=138153

参数说明：num_iid:景点id,

响应参数

Version: Date:2024-01-21

名称	类型	必须	示例值	描述
item	item[]	0		携程旅行景点详情数据

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python
• Golang
• javascript
• JS-SDK
• Ruby
• Swift
• Objective-C
• C
• C++
• Node.JS
• Kotlin
• Rust
• R
• MATLAB

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/xiecheng/item_get_scenic/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=138153"

响应示例

{
    "item":{
        "address":"新余市渝水区西南郊16公里处仙女湖风景区",
        "area_id":"xinyu878",
        "desc":"仙女湖景区位于江西省新余市西南郊16公里处，以“情爱圣地、群岛峡谷曲水、水下千年古城、亚热带植物基因库”四绝著称。景区面积198平方公里，其中水域面积50平方公里，由舞龙湖景区、钟山峡景区和钤阳湖景区三部分组成，穿插交错着99座岛屿星罗棋布，60多条湖湾扑朔迷离。舞龙湖景区作为仙女湖景区的主景区，涵盖龙凤苑、民俗风情园、爱情岛、龙王岛、圣集寺、名人岛、桃花岛等景点。走进仙女湖，你会惊叹：此景只应天上有，人间难得几处觅！仙女湖，感觉永如初心相见，成就了一段人仙相恋的千年传奇。东晋文学家干宝所著古籍《搜神记》里，毛衣仙女在此下凡，演绎出毛衣女与檀郎的爱情故事。这里，也因此成为了人间的情爱圣地，情山爱水向你诉说别离苦、相见欢。仙女湖因此也成为了“中国七仙女传说之乡”和 “中国七夕情人节”的发祥地。一、玩在仙女湖七夕老街七夕老街位于仙女湖码头片区中心地带，整个街区从整体布局到具体的景观、建筑、交通组织、产业落位都体现着创新的思想，以注重游客体验为核心，强调精致化、品质化与主题化。街区由徽派特色马头墙、仿古外立面门窗、回廊、商业街景观亭台楼阁等建筑组成，更好的展示仙女湖的人文风貌，给游客美好难忘的游玩体验。七夕老街融合新余民宿特色、民俗娱乐、民俗活动、本地特色小吃为一体，酒楼、客栈、酒吧、茶楼、戏台点缀其间，是集游客服务、观光娱乐、美食购物、度假休闲等功能为一体，以体验闲生活、慢生活、新生活的古风情的商业特色休闲街区。2021年，七夕老街荣获江西省省级旅游休闲街区。天工开物园天工开物园位于仙女湖沁庐度假酒店旁，紧邻七夕老街、七夕演艺中心，总建筑面积约1250㎡，主要是两层设计，商铺总计46间，由钢结构集装箱打造，风格时尚、鲜明、独特。天工开物园整体定位为商业休闲街区，由儿童互动娱乐区、酒吧餐饮区、文创轻食区三部分组成，目标人群以年轻人、情侣及小家庭为主。天工开物园的出现将为所有游客提供时尚休闲、互动娱乐、亲子游玩的高沉浸性、互动性新体验。七仙女渔乐园七仙女渔乐园是一个水上休闲渔趣乐园，具有赏鱼观光、人鱼互动、趣味捕鱼、垂钓、露天野营等休闲娱乐服务，并具备承接各类垂钓赛事及各类户外拓展活动的功能。园内有各式观赏鱼：色彩艳丽的锦鲤鱼、形态奇异的鸭嘴鱼、来势凶猛的黄金鱼群等。惊险刺激的人鱼互动项目有：浑水摸鱼、赤脚渡河、奶瓶喂鱼、当一日渔民等；趣味十足的水上运动有：水上激光碰碰船、特战船、皮划艇、浆板等。游客通过游玩观光，不但领略了仙女湖自然生态景观，饱览了各式各样的鱼类，更能体验水上运动的惊险刺激，让您成为仙女湖的主人，实现了一场忘我的旅行。七夕演艺中心七夕演艺中心矗立在仙女湖码头广场，依托于央视七夕晚会而打造的长期性演艺场馆。舞台以仙女下凡的爱情传说故事为设计主题，以半球形钢架结构建筑，融合地球和天堂、凡间与仙界的爱情元素，在充分展示仙女湖爱情文化的同时，也增加了景区建筑物的美感。七夕演艺中心是仙女湖一个具有重要意义的标志性的艺术性建筑，舞台结构一半拱门，一半倒影，形成一个完整的圆，代表充实，只有他们在一起，才能成为一个整体。舞台通过变幻莫测的五彩灯光、宛如天籁的缥缈音乐、返朴归真的造景和清新隽永的舞美，力图为观众打造一场梦幻般的视觉盛宴，形成一台气势恢宏的山水实景演出。仙女湖汽车影院仙女湖汽车影院坐落在仙女湖沁庐度假酒店西侧的停车场内。在这里你可以享受不被打扰的私人观影空间，坐在车内就可以获得自由的观影。仙幻爱情艺术馆仙幻爱情艺术馆位于仙女湖七夕老街鹊桥旁，场馆建设依托仙女湖“羽人传说”的特色文化，通过集成25个互动体验场景，以“仙幻美拍、情感体验、爱的启迪”为主题，与教育、艺术开发相结合，给游客娱乐打卡带来全新体验。二、游在仙女湖圣集寺圣集寺由叫佛教文化博览园，位于仙女湖钟山峡南岸的仙人台处，是由五台山佛教协会会长妙江大和尚亲自开山主持的一处佛教道场，因此延续了五台山佛教名山的历史文化脉络。圣集寺占地约2500亩，主峰高度432米，由圣集寺、文殊道场、观音道场、梅庵、禅园、佛教文化广场、禅修区、汉式佛塔、藏式白塔等组成。寺内有天.王殿，祈殿，雷音宝殿和藏经楼四个大殿。殿内分别供奉着大肚弥勒菩萨，韦驮菩萨，药师佛，日光菩萨，月光菩萨以及毗卢遮那佛等。圣集寺三面环山，一面临湖，山脉首尾相连，势若游龙，从东部望去，恍如“雄狮踏云”而来，是仙女湖的一块佛门净地。龙凤苑龙凤苑南北似腾飞的龙，东西象展翅的凤，故而得名“龙凤苑”。龙凤历来都是瑞祥美好的象征，素有“龙凤呈祥”、“龙飞凤舞”等吉祥之说。游历过龙凤苑的朋友，都会多吉多福，百顺百利。龙凤苑占地116亩，密林树茂，景色宜人，景观丰富。依山傍水建有龙凤徽、九龙墀、蛇池、凤巢、龙蟠台、崇蛇坛、天鸟行空、白蛇传雕塑、鸵鸟行宫、舞龙飞船等内涵丰富的景观。民俗文化风情园民俗文化风情园是一处荟萃多民族民间艺术、民俗风情和民居建筑于一园的文化旅游景点。民俗文化风情园设有民俗大舞台，每天都有多场精彩的舞蹈，演绎仙女下凡的传说故事。游客朋友们还可以现场与我们的仙女进行互动，感受不一样的仙女湖文化。爱情岛爱情岛占地面积79920㎡，是集旅游观光、休闲娱乐、度假、会务拓展、婚纱摄影等多种功能于一体的岛屿。岛内有中式的大花轿、同心锁、姻缘井、抛绣球、洞房；西式的仿“科隆大教堂”、爱琴海、浪漫满屋、海景码头、日式风情街、欧陆风情街、宫廷水道等建筑。爱情岛以爱情文化为内涵，以传播爱情文化为理念，聚集众多的爱情文化元素，是天下有情人“爱的天堂”，是浪漫、邂逅及拍照的好地方！龙王岛龙王岛位于仙女湖湖内的中心部位，它的平面像橄榄，又似台湾宝岛；它的立面形似等腰三角形，有着比日本富士山更标准的轮廓。而从凌水崖石上看龙王岛，酷似一只神龟，它与龙王岛遥遥相望，形成了“神龟拜龙王”的神奇景观。龙王岛上也称猴岛，岛上有上百只野生的猴子，有的顽劣乖张，有的憨态可鞠，但都善察人意。您面带笑容，它则绕膝撒欢；您面含怒色，它则远遁规避。站在龙王岛顶端的龙王阁，可俯瞰仙女湖碧波荡漾、烟波浩渺的全景，大大小小的岛屿既象一颗颗镶嵌在绒毯上的绿宝石，又似一个个睡梦中的仙女。近岛远山，层峦迭嶂，茫茫苍苍，俨似一幅天然山水画。据说国画大师傅抱石先生当年和关山月合作“江山如此多娇”这幅巨作的灵感就来自于仙女湖的龙王岛。名人岛名人岛根据中国江南园林古朴典雅风格而建造，以新余古今名人为主要展示内容。全岛总面积65亩，由大小两个岛组成，从空中鸟瞰，大岛如苍龙卧波，小岛如翠珠凌水，俨然“苍龙戏珠”的天然景观。名人岛由名人植树园、名人雕塑园、抱石文化园三个园区组成。名人植树园，位于岛内醉笔堂的正前方，很多海内外名人雅士在此植树纪念。名人雕塑园挑选新余自三国吴宝鼎二年（267年）立县以来，众多进士及第者中杰出的12位名人，将其立塑像在绿树映掩之中。抱石文化园是纪念国画大师傅抱石先生的园林。园门按抱石故里——罗坊樟塘村“傅氏祠堂”的风格建造的。园前有一棵连理共生的香樟树，象征着傅抱石先生“德艺双馨”。园内傅抱石塑像是画家、雕刻家陈祖煌先生按照傅抱石当年为人民大会堂绘制《江山如此多娇》巨型油画时的神态制作而成。桃花岛这里因凡人走桃花运在此偶遇仙女，又因岛上遍布桃树而命名，以“上桃花岛行桃花大运”，“集桃文化做山水文章”为风味。桃花岛门楼由明清时代的古砖修建而成，门楼墙上的砖刻有“喻南学社”、“红德润堂”、“平恒公馆”、“新喻县城砖”等铭文，具有较高的文物研究价值。三、食在仙女湖仙遇记·生态鱼馆鱼，在中国传统文化中是富庶、繁荣的象征。逢年过节、喜庆筵席及亲朋团聚之时，餐桌上总少不了鱼肴。鱼，传达着人们对“年年有余、富贵有余”的美好愿望。仙女湖湖内鱼类丰富，一直坚持人放天养的饲养模式，主要饵料为浮游生物、底栖生物、水生植物等天然饵料，养殖用水为仙女湖的优质水源。水域环境优良，天然养殖周期长，肥美的鲜鱼深受青睐。仙遇记·生态鱼馆位于仙女湖湖畔，鱼馆沿用“七仙女”的“七文化”，经过多年实践经验，一直是取新鲜活鱼为原料，用多种烹调手法并融合新余七个地区的特色菜肴，独创一鱼七吃，让您品尝鱼汤鲜美的同时，又可以尝到鱼肉的鲜嫩口感。其菜品口感独特，老少皆宜，让人回味无穷，深得广大游客、市民的喜爱。仙遇记·生态鱼馆以品质求发展，以诚信求生存，经过几年的不懈努力，现已成为家喻户晓的特色美食餐馆。四、宿在仙女湖仙女湖沁庐度假酒店仙女湖沁庐度假酒店坐落在仙女湖湖畔，总建筑面积约1.2万㎡，客房117间，配有自助餐厅、中餐厅、休闲书吧、健身房、棋牌室、会议报告厅、会议室等。酒店以现代徽派为形，清新典雅的中式风格为内部装饰，融入江南山水与文旅度假景区优美环境中。酒店通过智慧控制系统及高环保静音空调，为来宾营造闲适惬意的休闲新生活。仙女湖沁庐度假酒店，让您远离城市的喧嚣，享受天然的舒畅。",
        "desc_img":[

        ],
        "detail_url":"https://you.ctrip.com/sight/xinyu878/138153.html",
        "english_name":"",
        "hot":"5.8",
        "item_imgs":[
            {
                "url":"https://dimg04.c-ctrip.com/images/350t0r000000hagjkB897.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/100g1f000001gr0co465B.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/350u0r000000haeflEE6C.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/35050r000000hcxrm8C3B.jpg"
            }
        ],
        "level":"4A",
        "open_time":"3/1-10/31 08:00-17:30开放;11/1-2/28 08:30-17:00开放，游船开船时间：09:20,10:10,11:00,12:00,13:00,13:40",
        "poiid":99330,
        "ranking":"新余自然风光景点榜 No.1",
        "reviews_num":950,
        "score":4.2,
        "service ":[
            {
                "name":"停车场",
                "value":"【仙女湖停车场】参考价格：¥10/次；地址：新余市渝水区西南郊16公里处仙女湖景区门楼进入右拐；库位：620；无大小车之分"
            },
            {
                "name":"园内交通",
                "value":"参考价格：收费；地址：游船码头"
            },
            {
                "name":"卫生间",
                "value":"景区内设有卫生间，在西北门北侧附近，并标有醒目的指示牌。"
            },
            {
                "name":"餐饮",
                "value":"园内设有餐厅，在东南门北侧等附近。"
            }
        ],
        "telephone":"4009158099",
        "tips":[

        ],
        "title":"仙女湖",
        "upgrade":[
            {
                "name":"新余市民",
                "value":"新余本地市民，注：五一、十一、春节期间四县居民不享受免门票优惠政策，免门票"
            }
        ]
    },
    "_ddf":"curry",
    "error":"",
    "reason":"",
    "error_code":"0000",
    "cache":0,
    "api_info":"today: max:15000 all[=++];expires:2031-01-01",
    "execution_time":"3.878",
    "server_time":"Beijing/2024-01-21 18:11:06",
    "client_ip":"127.0.0.1",
    "call_args":[

    ],
    "api_type":"xiecheng",
    "server_memory":"2.99MB",
    "last_id":false
}

异常示例

{
  "error": "item-not-found",
  "reason": "没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2023-12-15 17:44:00",
  "call_args": [],
  "api_type": "xiecheng",
  "request_id": "1ee0ffc041242"}

相关资料

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否

请求成功时，响应数据为景点的详细信息，包括景点名称、地址、电话、开放时间等。

请求失败时，响应数据为错误信息。

需要注意的是，使用该API需要携程账户，并且需要获取授权token。具体的操作方法可以参考携程开放平台的文档。