# Proxy约定说明 用户可在luban系统(my.mipuyun.com)管理我们提供的高质量住宅代理。 为了更有效的使用代理，对于Proxy字段的发送提供以下约定 --- ## 1. 指定代理地区/国家 在proxy名后拼接 `-国家码(地区码)`，myproxy是代理命名，举例如下： | 地区(国家) | 码 | Proxy命名举例 | |-----------|---|--------------| | 美国 | us | myproxy-us | | 法国 | fr | myproxy-fr | | 英国 | uk | myproxy-uk | | **欧洲** | **eu** | **myproxy-eu** | --- ## 2. 利用多个代理提升agent质量 为提升agent对接的质量，支持在proxy字段输入多个代理，并提供串行和并发来满足各种场景 ### 拼接符号介绍 | 符号 | 说明 | |------|------| | **竖线 \|** | 多个代理随机选择 | | **逗号 ,** | 多个代理串行选择，希望提升成功率，但可以接受响应速度略慢的场景 | | **加号 +** | 多个代理并发执行，应用于有较高成功率&较低响应速度的场景 | ### 代理使用示例 | 代理举例 | 适合场景 | 效果 | |----------|---------|------| | myproxy-us | 所有场景 | 指定US地区进行agent执行 | | myproxy-us\|myproxy-uk | 所有场景 | 从US, UK两个地区随机选择一个进行agent执行 | | myproxy-us\|myproxy-uk,myproxy-us\|myproxy-eu | **shopping/search** | 仅对shpping/search生效，可接受较大的响应时长等待，第一轮采用myproxy-us\|myproxy-uk进行对接。如果成功，立即返回结束业务。如果失败，采用myproxy-us\|myproxy-eu启动第二轮对接。 | | myproxy-us + myproxy-uk | **shopping/select**
**shopping/baggage**
**shopping/seat** | 采用多线程并发模式，线程a采用myproxy-us,线程b采用myproxy-uk, 同时向航司发起业务请求。 | | myproxy-us\|myproxy-eu + myproxy-uk\|myproxy-uk | **shopping/select**
**shopping/baggage**
**shopping/seat** | 采用多线程并发模式，线程a采用myproxy-us\|myproxy-eu,线程b采用myproxy-uk\|myproxy-uk, 同时向航司发起业务请求。 | --- ## 3. 异常处理 ### 如果将符号用在了不支持的场景怎么办？ 系统会最大限度接受异常的代理串输入，但会选择最保守的执行方式，我们会采集最小的代理信息进行执行。 **示例**： - 并发场景(select/baggage/seat)收到逗号：`myproxy-us,myproxy-uk` - 那么执行层会变成：`myproxy-us`