{
"country": {
"iso2": "FR",
"name": "France"
},
"service": "restaurant",
"custom": {
"level": "appreciated",
"method": "percent",
"percent": [
5,
10
],
"text": "Appreciated at restaurants: 5-10% of the bill."
},
"serviceChargeIncluded": true,
"tip": {
"low": 0,
"high": 8.6,
"suggested": 4,
"suggestedPercent": 4.65
},
"total": {
"low": 86,
"high": 94.6,
"suggested": 90,
"roundedUp": 90
},
"advice": "A service charge is usually already on the bill here, so the suggestion is just rounding up; the range is for exceptional service.",
"note": "\"Service compris\": service is included by law; leaving a few euros for good service is common but optional.",
"confidence": "high",
"sourceCount": 3,
"disclaimer": "General guidance compiled from public sources that sometimes disagree; customs vary by city, venue and service, and change over time. Check the bill for a service charge, and follow local signs and staff where they differ."
}
curl --location --request GET 'https://zylalabs.com/api/14691/tipping+customs+by+country+api/37973/how+much+to+tip+for+a+service+in+a+country?country=FR&service=restaurant&amount=86' --header 'Authorization: Bearer YOUR_API_KEY'
{
"found": true,
"country": {
"iso2": "JP",
"name": "Japan",
"services": {
"restaurant": {
"level": "avoid",
"method": "none",
"text": "Don't tip at restaurants: it goes against local custom."
},
"taxi": {
"level": "avoid",
"method": "none",
"text": "Don't tip for taxis: it goes against local custom."
},
"hotel": {
"level": "not-expected",
"method": "none",
"text": "Not expected for housekeeping."
},
"guide": {
"level": "not-expected",
"method": "none",
"text": "Not expected for tour guides."
}
},
"serviceChargeIncluded": false,
"serviceCharge": "sometimes",
"note": "Tipping is not practiced and can cause confusion; excellent service is the norm. Upscale hotels and restaurants may add a service charge.",
"confidence": "high",
"confidenceReason": "Both independent references agree with our restaurant custom.",
"sourceCount": 3
},
"disclaimer": "General guidance compiled from public sources that sometimes disagree; customs vary by city, venue and service, and change over time. Check the bill for a service charge, and follow local signs and staff where they differ."
}
curl --location --request GET 'https://zylalabs.com/api/14691/tipping+customs+by+country+api/37974/tipping+customs+of+a+country+all+four+services&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"q": "korea",
"count": 0,
"total": 0,
"countries": [],
"disclaimer": "General guidance compiled from public sources that sometimes disagree; customs vary by city, venue and service, and change over time. Check the bill for a service charge, and follow local signs and staff where they differ."
}
curl --location --request GET 'https://zylalabs.com/api/14691/tipping+customs+by+country+api/37975/find+countries+by+name+or+code+with+filters?q=korea&service=restaurant&level=expected&confidence=high&serviceCharge=usually' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 12,
"countries": [
{
"iso2": "BW",
"name": "Botswana",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "low",
"sourceCount": 1
},
{
"iso2": "KE",
"name": "Kenya",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "low",
"sourceCount": 1
},
{
"iso2": "KP",
"name": "North Korea",
"restaurant": "not-expected",
"serviceChargeIncluded": false,
"confidence": "low",
"sourceCount": 2
},
{
"iso2": "MW",
"name": "Malawi",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "low",
"sourceCount": 1
},
{
"iso2": "NA",
"name": "Namibia",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "medium",
"sourceCount": 2
},
{
"iso2": "NP",
"name": "Nepal",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "high",
"sourceCount": 2
},
{
"iso2": "RW",
"name": "Rwanda",
"restaurant": "appreciated",
"serviceChargeIncluded": false,
"confidence": "high",
"sourceCount": 2
},
{
"iso2": "TZ",
"name": "Tanzania",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "medium",
"sourceCount": 2
},
{
"iso2": "UG",
"name": "Uganda",
"restaurant": "appreciated",
"serviceChargeIncluded": false,
"confidence": "high",
"sourceCount": 2
},
{
"iso2": "ZA",
"name": "South Africa",
"restaurant": "expected",
"serviceChargeIncluded": false,
"confidence": "high",
"sourceCount": 2
},
{
"iso2": "ZM",
"name": "Zambia",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "medium",
"sourceCount": 2
},
{
"iso2": "ZW",
"name": "Zimbabwe",
"restaurant": "customary",
"serviceChargeIncluded": false,
"confidence": "high",
"sourceCount": 2
}
],
"disclaimer": "General guidance compiled from public sources that sometimes disagree; customs vary by city, venue and service, and change over time. Check the bill for a service charge, and follow local signs and staff where they differ."
}
curl --location --request GET 'https://zylalabs.com/api/14691/tipping+customs+by+country+api/37976/every+country+compact+with+optional+filters?service=guide&level=expected' --header 'Authorization: Bearer YOUR_API_KEY'
{
"services": [
{
"service": "restaurant",
"label": "Restaurants and cafés (table service)",
"amountIs": "the bill",
"unit": null,
"levels": {
"expected": 6,
"customary": 102,
"appreciated": 86,
"not-expected": 21,
"avoid": 3
}
},
{
"service": "taxi",
"label": "Taxis and rideshare",
"amountIs": "the fare",
"unit": null,
"levels": {
"expected": 0,
"customary": 25,
"appreciated": 127,
"not-expected": 63,
"avoid": 3
}
},
{
"service": "hotel",
"label": "Hotel housekeeping",
"amountIs": "not used (a fixed amount per night)",
"unit": "night",
"levels": {
"expected": 0,
"customary": 30,
"appreciated": 163,
"not-expected": 25,
"avoid": 0
}
},
{
"service": "guide",
"label": "Tour guides (day tours)",
"amountIs": "not used (a fixed amount per person per day)",
"unit": "person-day",
"levels": {
"expected": 12,
"customary": 149,
"appreciated": 50,
"not-expected": 7,
"avoid": 0
}
}
],
"levels": {
"expected": "Expected: skipping it is read as a complaint about the service.",
"customary": "Customary: most people tip; it is part of the price in practice.",
"appreciated": "Appreciated: optional; locals often round up or leave small change, more for good service.",
"not-expected": "Not expected: locals don't tip; a tip is unusual but harmless.",
"avoid": "Avoid: tipping goes against local custom and can confuse or embarrass."
},
"methods": {
"percent": "A percent of the bill or fare.",
"round-up": "Round the bill or fare up to a convenient figure.",
"amount": "A fixed amount, given as its US dollar equivalent (pay in local currency).",
"none": "No tip."
},
"serviceCharge": {
"usually": "A service charge is usually on restaurant bills (by law or near-universal).",
"sometimes": "Often added at some places: check the bill and don't tip twice.",
"rarely": "Rarely added."
},
"disclaimer": "General guidance compiled from public sources that sometimes disagree; customs vary by city, venue and service, and change over time. Check the bill for a service charge, and follow local signs and staff where they differ."
}
curl --location --request GET 'https://zylalabs.com/api/14691/tipping+customs+by+country+api/37977/the+services+levels+and+methods+explained+with+counts' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 各国小费习俗 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
任何:将账单或票价以当地货币的数字形式发送,小费用相同的货币返回。家务和导游的小费是固定金额,以美元等值进行转换
在那个国家餐馆账单上通常已经包含服务费(法律或普遍惯例)。然后建议的小费只是四舍五入,范围是针对卓越服务的
每个国家都有一个sourceCount和一个confidence:当独立参考与我们一致时为高,当它们只在程度上有所不同时为中等,当没有参考覆盖该国或有一个不同意见时为低。习俗因城市和场地而异,因此将其视为指导
是的:ISO 代码(JP)、英文名称(日本)和常见别名(英国、荷兰、缅甸、土耳其、科特迪瓦)都可以使用
不 每次调用都是在内存中查找 并且没有日志记录
每个端点返回与不同国家各种服务的小费习俗相关的数据。这包括预期的小费水平、方法、百分比以及针对餐厅、出租车、酒店和导游的具体建议
关键字段包括“国家”(带有ISO代码和名称)“服务”(服务类型)“自定义”(级别和方法)“小费”(低,高,建议)“总额”(计算金额)和“建议”(小费指导)
参数包括国家标识符(ISO 代码或名称)、服务类型(餐厅、出租车、酒店、导游)以及信心水平和服务费包含的过滤器。用户可以根据这些参数自定义请求
响应数据采用JSON格式结构化,包含国家详细信息、服务类型、小费习惯和建议的嵌套对象。每种服务类型都有自己的一套字段,详细说明小费水平和方式
该数据来自多个公共来源,包括提供当地小费习俗见解的独立参考 每个条目都包括一个“sourceCount”表示支持该信息的参考数量
典型的使用案例包括寻找外国小费习俗指导的旅行者 提供旅行建议的企业以及将小费信息集成到旅行应用或服务中的开发者
用户可以利用这些数据了解当地的小费习惯根据服务费用计算合适的小费并遵循建议以提升他们的旅行体验这个结构化格式便于集成到应用程序中
数据准确性通过定期更新和与多个来源交叉参考来维护 “可信度”评级表示信息的可靠性,帮助用户评估提供数据的可信度