各国小费习俗 API

API ID 14691

218个国家的给小费习俗(餐厅出租车酒店导游)和小费计算器

API 文档

端点

请求
习惯:水平(预期的,习惯的,受到赞赏的,意外的,避免的)和方法(百分比,向上取整,金额,无)。百分比和向上取整的习惯需要金额(账单或费用,任何货币的单纯数字):小费.低/高/建议和总额。固定金额的习惯(每晚酒店客房清洁,每人每天的导游费用)给出小费.美元等值 × 单位:以当地货币支付等值。服务费已包含:餐厅账单上通常已经包含服务费(建议只是向上取整)。建议:一两句显示如其所是。
Endpoint ID: 37973
GET https://zylalabs.com/api/14691/tipping+customs+by+country+api/37973/how+much+to+tip+for+a+service+in+a+country
输入参数

在一个国家服务应该给多少小费 — 端点功能

对象 描述
country 必需 ISO code or name.
service 必需 restaurant, taxi (rideshare, uber, cab), hotel (housekeeping) or guide (tour).
amount 可选 The bill or fare, a plain number (48.50, 5000). Needed for percent and round-up customs.
units 可选 Nights (hotel) or person-days (guide), 1-365 (default 1).

剩余免费测试请求:3 / 3。


输入参数

country
service
amount
units
API 示例响应
JSON
{
    "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' 


    
请求
通过ISO 3166-1 alpha-2代码(任意大小写)、英文名称或常见别名(英国、荷兰、缅甸、土耳其、象牙海岸) 服务:餐厅、出租车、酒店、导游,每项服务都有级别、方式、百分比或美元等值,以及一句话 服务费包含(布尔值)和服务费(通常,有时,很少) 来源数量:我们的汇编加上每个独立参考的共识 信心和信心理由 表中没有:找到:假与建议
Endpoint ID: 37974
GET https://zylalabs.com/api/14691/tipping+customs+by+country+api/37974/tipping+customs+of+a+country+all+four+services
输入参数

剩余免费测试请求:3 / 3。

API 示例响应
JSON
{
    "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 匹配名称 代码和别名(单词开头 忽略重音) 过滤器:级别(有服务 默认餐厅) 信心 服务费
Endpoint ID: 37975
GET https://zylalabs.com/api/14691/tipping+customs+by+country+api/37975/find+countries+by+name+or+code+with+filters
输入参数

通过名称或代码和筛选器查找国家 — 端点功能

对象 描述
q 可选 Name, code or alias.
service 可选 Service the level filter applies to (default restaurant).
level 可选 expected, customary, appreciated, not-expected or avoid.
confidence 可选 high, medium or low.
serviceCharge 可选 usually, sometimes or rarely.
limit 可选 1-100 (default 20).

剩余免费测试请求:3 / 3。


输入参数

q
service
level
confidence
serviceCharge
limit
API 示例响应
JSON
{
    "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' 


    
请求
每个国家(紧凑),带可选过滤器
Endpoint ID: 37976
GET https://zylalabs.com/api/14691/tipping+customs+by+country+api/37976/every+country+compact+with+optional+filters
输入参数

每个国家都有带可选过滤器的协议 — 端点功能

对象 描述
service 可选 Service for the level filter.
level 可选 Level. (level parameter)
confidence 可选 high, medium or low.
serviceCharge 可选 usually, sometimes or rarely.

剩余免费测试请求:3 / 3。


输入参数

service
level
confidence
serviceCharge
API 示例响应
JSON
{
    "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' 


    
请求
服务、级别和方法的说明,以及数量
Endpoint ID: 37977
GET https://zylalabs.com/api/14691/tipping+customs+by+country+api/37977/the+services+levels+and+methods+explained+with+counts
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "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 端点。要使用 各国小费习俗 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

为218个国家的消费习惯(餐馆、出租车、酒店、导游)以及小费计算器

各国小费习俗 API FAQs

任何:将账单或票价以当地货币的数字形式发送,小费用相同的货币返回。家务和导游的小费是固定金额,以美元等值进行转换

在那个国家餐馆账单上通常已经包含服务费(法律或普遍惯例)。然后建议的小费只是四舍五入,范围是针对卓越服务的

每个国家都有一个sourceCount和一个confidence:当独立参考与我们一致时为高,当它们只在程度上有所不同时为中等,当没有参考覆盖该国或有一个不同意见时为低。习俗因城市和场地而异,因此将其视为指导

是的:ISO 代码(JP)、英文名称(日本)和常见别名(英国、荷兰、缅甸、土耳其、科特迪瓦)都可以使用

不 每次调用都是在内存中查找 并且没有日志记录

每个端点返回与不同国家各种服务的小费习俗相关的数据。这包括预期的小费水平、方法、百分比以及针对餐厅、出租车、酒店和导游的具体建议

关键字段包括“国家”(带有ISO代码和名称)“服务”(服务类型)“自定义”(级别和方法)“小费”(低,高,建议)“总额”(计算金额)和“建议”(小费指导)

参数包括国家标识符(ISO 代码或名称)、服务类型(餐厅、出租车、酒店、导游)以及信心水平和服务费包含的过滤器。用户可以根据这些参数自定义请求

响应数据采用JSON格式结构化,包含国家详细信息、服务类型、小费习惯和建议的嵌套对象。每种服务类型都有自己的一套字段,详细说明小费水平和方式

该数据来自多个公共来源,包括提供当地小费习俗见解的独立参考 每个条目都包括一个“sourceCount”表示支持该信息的参考数量

典型的使用案例包括寻找外国小费习俗指导的旅行者 提供旅行建议的企业以及将小费信息集成到旅行应用或服务中的开发者

用户可以利用这些数据了解当地的小费习惯根据服务费用计算合适的小费并遵循建议以提升他们的旅行体验这个结构化格式便于集成到应用程序中

数据准确性通过定期更新和与多个来源交叉参考来维护 “可信度”评级表示信息的可靠性,帮助用户评估提供数据的可信度

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API