aliexpress.接入API文档说明及参数说明

Posted 2023-04-04 电商数据girl

item_get-获得aliexpress商品详情 

aliexpress.item_get

公共参数

请求地址: 

名称	类型	必须	描述
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=4000926586732

参数说明：num_iid:aliexpress商品ID

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	32667038134	商品ID
title	String	0	女装T恤短袖吸湿快速干燥健身T恤女装上衣	商品标题
desc_short	String	0		商品简介
price	String	0	4.35-4.68	价格
total_price	Int	0	0
suggestive_price	Int	0	0
orginal_price	String	0	6.21-6.68	原价
nick	String	0	SILVERCELL SILVERCELL Store	买卖方昵称
num	Int	0	1799	可购买商品数量
min_num	Int	0	0
detail_url	String	0	https://www.aliexpress.com/item//32667038134.html	商品链接
pic_url	String	0	https://ae01.alicdn.com/kf/HTB12r_yabEF6uJjSZFOq6xUvVXa1/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg	商品图片
brand	String	0		品牌名称
brandId	Bigint	0		品牌ID
rootCatId	Bigint	0	100003109	顶级分类ID
cid	Bigint	0
crumbs	Mix	0	"100003109": "女性着装", "100003127": "T恤", "200000785": "上衣和T恤"	导航菜单
created_time	Date	0		创建时间
modified_time	Date	0		修改时间
delist_time	Date	0		删除时间
desc	String	0
desc_img	Mix	0	[]	商品描述图片
item_imgs	Mix	0	["url": "https://ae01.alicdn.com/kf/HTB12r_yabEF6uJjSZFOq6xUvVXa1/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg"]	商品图片
item_weight	Float	0	0.25	包装重量
item_size	String	0	22|18|20	包装尺寸
location	String	0		发货地
post_fee	Float	0	6.00	物流费用
express_fee	Float	0	6.00	快递费用
ems_fee	Float	0	6.00	EMS费用
shipping_to	String	0		发货至
has_discount	Boolean	0		是否有折扣
video	Mix	0	[]	商品视频
is_virtual	Boolean	0
sample_id	Bigint	0		商品风格标识ID
is_promotion	Boolean	0
props_name	String	0	14:193:Color:Black;5:361385:Size:L	商品属性名
prop_imgs	Mix	0	"prop_img": ["properties": "14:193", "url": "https://ae01.alicdn.com/kf/HTB1Q9GWJVXXXXXoXXXXq6xXFXXXp/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg"]	商品属性图片列表
property_alias	String	0	14:193:Black;5:361385:L	商品属性别名
props	Mix	0	[ "name": "上衣类型","value": "T恤" ]	商品详情
total_sold	Int	0	110	总销量
skus	Mix	0	"sku": ["price": "4.61", "orginal_price": "6.58", "properties": "14:193;5:361385", "properties_name": "Color:Black::;Size:L::", "quantity": 100, "sku_id": "14:193;5:361385"]	商品规格信息
seller_id	Bigint	0		卖家ID
sales	Int	0		销量
shop_id	Bigint	0		店铺ID
props_list	Mix	0	"Color:Black": ":","Size:L": ":"	商品属性
seller_info	Mix	0	"nick": "", "city": " China ", "level": "", "rate": "", "score": "", "delivery_score": "", "item_score": "", "shop_type": "", "user_num_id": "", "sid": "206074139", "title": "I", "zhuy": "//www.aliexpress.com/store/933191", "menu": []	卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	Mix	0
score	Float	0	4.8	商品评分
votes	Int	0	49	评分人数
stuff_status	String	0
shopinfo	Mix	0	"shop_name": ""	店铺信息
promo_type	String	0
shop_item	Mix	0	[]
relate_items	Mix	0	[]
packaging	Mix	0	[ "name": "Package Size","value": "22cm x 18cm x 20cm (8.66in x 7.09in x 7.87in)"]	包装信息
current_lang	String	0	en
currency_code	String	0	USD
props_img	Mix	0	"14:193": "https://ae01.alicdn.com/kf/HTB1Q9GWJVXXXXXoXXXXq6xXFXXXp/Women-T-Shirt-Short-Sleeves-Hygroscopic-Quick-Drying-Fitness-T-shirt-Women-Top-Clothes.jpg"	属性图片

1. 参数说明

   • 通用参数说明

     • version:API版本
     • key:调用key,测试key:test_api_key
     • api_name:API类型[item_search,item_get]
     • cache:[yes,no]默认yes，将调用缓存的数据，速度比较快
     • result_type:[json,xml,serialize,var_export]返回数据格式，默认为json
     • lang:[cn,en,ru] 翻译语言，默认cn简体中文

   • API:item_search 参数说明: q:搜索关键词 cat:分类ID start_price:开始价格 end_price:结束价格 sort:排序 page:

   • API:item_get 参数说明: num_iid:商品id【num_iid=1520294】

2. 此API目前支持以下基本接口：

   • item_get 获得aliexpress商品详情
   • item_search 按关键字搜索aliexpress商品
   • cat_get 获得aliexpress分类详情

速码验证码接码平台API接入示例说明

速码平台API接口示例【通用版】

一、统一说明

• 接口地址：http://api.eobzz.com/httpApi.do?action=
• 接口统一编码：UTF-8
• 接口调用方式： HTTP，支持GET和POST两种方式。
• GET方式调用实例：http://api.eobzz.com/httpApi.do?action=方法名&参数1=值&参数2=值（具体方法名及参数请参考接口方法）。

 

软件开发者说明：服务器返回no_data时表示系统暂时没有可用号码了，请使用死循环每隔一分钟请求一次手机号，速码平台是不定时加号的。 max_count_disable出现这个提示是因为您获取的号码没有正常处理，每个获取到的号码都必须正确处理(要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑。getRecvingInfo方法可以查看您当前获取的手机号码 如果接口返回action_parameter_error 表示传入方法名错误或方法不存在。

 

 

 

二、接口方法

1、用户登录

1）方法名：loginIn

2）传入参数：

• uid:用户名：
• pwd:密码

3）GET方式调用实例：

• http://api.eobzz.com/httpApi.do?action=loginIn&uid=用户名&pwd=密码

4）方法调用返回值示例：

1））成功返回：用户名|token(下面所有方法都要用的令牌)

2））失败返回值&说明：

• login_error用户名密码错误
• message|速度过快，请稍后再试访问速度过快，建议休眠50毫秒后再试
• account_is_locked账号被锁定
• account_is_stoped账号被停用
• account_is_question_locked账号已关闭
• account_is_ip_stoped账号ip锁定
• account_is_FreezeUser账号被冻结

2、获取用户个人信息

1）方法名：getUserInfos

2）传入参数：

• uid:用户名
• token=登录时返回的令牌

3）GET方式调用实例：

• http://api.eobzz.com/httpApi.do?action=getUserInfos&uid=用户名&token=登录时返回的令牌

4）方法调用返回值示例：

1））成功返回：用户名;积分;余额;可同时获取号码数
2））失败返回值&说明：

• parameter_error传入参数错误
• not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token
• account_is_locked账号被锁定
• account_is_stoped账号被停用
• account_is_question_locked账号已关闭
• account_is_ip_stoped账号ip锁定
• message|please try again later访问速度过快，建议休眠50毫秒后再试
• unknow_error未知错误,再次请求就会正确返回

3、获取手机号码

1）方法名：getMobilenum

2）传入参数：

• pid=项目ID
• uid=登录用户名
• token=登录时返回的令牌
• mobile=指定号码获取(可以不填写该参数，如填入格式不正确则获取新号码)
• size=获取号码数(可以不填，默认为1，1<=size<=10)
• province=归属地（省份，例如：广东、北京）
• province值：广东|辽宁|湖南|内蒙古|浙江|安徽|贵州|西藏|黑龙江|陕西|广西|湖北|福建|山西|江西|海南|江苏|云南|河南|山东|新疆|青海|吉林|河北|宁夏|北京|天津|上海|四川|重庆|甘肃
• province中文传参时可能产生乱码，最好经过URL转码,（例如：java转码方式 java.net.URLEncoder.encode("广东","UTF-8")）。
• phoneType=运营商（CMCC（移动）、UNICOM（联通）、TELECOM（电信）） 。

3）GET方式调用实例：

• http://api.eobzz.com/httpApi.do?action=getMobilenum&pid=项目 ID&uid=用户名&token=&mobile=&size=1

4）归属地、运营商调用实例：

• http://api.eobzz.com/httpApi.do?action=getMobilenum&pid=项目 ID&uid=用户名&token=&mobile=&size=1&province=广东&phoneType=CMCC

5）方法调用返回值示例：

1））成功返回：手机号码|token

注意：多个号码返回值：手机号;手机号;手机号| token

2））失败返回值&说明：

• no_data系统暂时没有可用号码了
• parameter_error传入参数错误
• not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token
• account_is_locked账号被锁定
• account_is_stoped账号被停用
• account_is_question_locked账号已关闭
• account_is_ip_stoped账号ip锁定
• message|速度过快，请稍后再试访问速度过快，建议休眠50毫秒后再试
• not_found_project没有找到项目,项目ID不正
• message|可使用余额不足可使用余额不足
• max_count_disable已经达到了当前等级可以获取手机号的最大数量，请先处理完您手上的号码再获取新的号码（处理方式：能用的号码就获取验证码，不能用的号码就加黑）
• unknow_error未知错误,再次请求就会正确返回

4、获取验证码并不再使用本号

1）方法名：getVcodeAndReleaseMobile

2）传入参数：

• mobile=用getMobilenum方法获取到的手机号
• token=登录时返回的令牌
• uid=用户名
• author_uid=软件开发者用户名(可选, 可得10%的消费分成)

3）GET方式调用实例：

• http://api.eobzz.com/httpApi.do?action=getVcodeAndReleaseMobile&uid=用户&token=登录时返回的令牌&mobile=获取到的手机号码&author_uid=软件开发者用户名(可选, 可得10%的消费分成)

4）方法调用返回值示例：

1））成功返回：手机号码|验证码短信

2））失败返回值&说明：

• ?       not_receive还没有接收到验证码,请让程序等待几秒后再次尝试
• ?       parameter_error传入参数错误
• ?       not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token
• ?       account_is_locked账号被锁定
• ?       account_is_stoped账号被停用
• ?       account_is_question_locked账号已关闭
• ?       account_is_ip_stoped账号ip锁定
• ?       message|please try again later访问速度过快，建议休眠50毫秒后再试
• ?       message|可使用余额不足可使用余额不足
• ?       not_found_moblie没有找到手机号
• not_found_project没有找到项目,项目ID不正确

5、获取验证码并继续使用本号

1）方法名：getVcodeAndHoldMobilenum

2）传入参数：

• mobile=用getMobilenum方法获取到的手机号
• uid=用户名
• token=登录时返回的令牌
• next_pid=下个要接收的项目ID
• author_uid=软件开发者用户名(可选, 可得10%的消费分成)

3）GET方式调用实例：

• http://api.eobzz.com/httpApi.do?action=getVcodeAndHoldMobilenum&uid=用户&token=登录时返回的令牌&mobile=获取到的手机号码&next_pid=下个要接收的项目ID&author_uid=软件开发者用户名(可选, 可得10%的消费分成)

4）方法调用返回值示例：

1））成功返回：发送号码|验证码| token

2））失败返回值&说明：

• ?       not_receive还没有接收到验证码,请让程序等待几秒后再次尝试
• parameter_error传入参数错误
• not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token
• account_is_locked账号被锁定
• account_is_stoped账号被停用
• account_is_question_locked账号已关闭
• ?       account_is_ip_stoped账号ip锁定
• message|please try again later访问速度过快，建议休眠50毫秒后再试
• message|可使用余额不足可使用余额不足
• not_found_moblie没有找到手机号
• not_found_project没有找到项目,项目ID不正确
• unknow_error未知错误,再次请求就会正确返回

6、加黑无用号码

1）方法名：addIgnoreList

2）传入参数：

• pid=项目ID
• mobiles=以,号分隔的手机号列表
• uid=用户名
• token=登录时返回的令牌

3）GET方式调用实例：

• ? http://api.eobzz.com/httpApi.do?action=addIgnoreList&uid=用户名&token=登录时返回的令牌&mobiles=号码1,号码2,号码3&pid=项目ID

4）方法调用返回值示例：

1））成功返回：加黑成功的号码数量

2））失败返回值&说明：

• ? parameter_error传入参数错误
• ? not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token
• ? account_is_locked账号被锁定
• ? account_is_stoped账号被停用
• ? account_is_question_locked账号已关闭
• ? account_is_ip_stoped账号ip锁定
• ? unknow_error未知错误,再次请求就会正确返回

7、已获取号码列表

1）方法名：getRecvingInfo

2）传入参数：

• uid=用户名
• token=登录时返回的令牌
• pid=项目ID（pid等于0的时候获取所有号码，pid不等于0的时候获取指定项目号码）

3）GET方式调用实例：

• http://api.eobzz.com/httpApi.do?action=getRecvingInfo&uid=用户名&pid=项目ID&token=登录时返回的令牌

4）方法调用返回值示例：

1））成功返回： 没有获取号码记录:[ ] 单条：[{"Pid":项目ID,"Recnum":号码,"Timeout":号码超时释放所剩时间,"Start_time":获取号码时间}]（*"Timeout"以秒为单位） 多条：[{"Pid":项目ID,"Recnum":号码,"Timeout":号码超时释放所剩时间,"Start_time":获取号码时间},{"Pid":项目ID,"Recnum":号码,"Timeout":号码超时释放所剩时间,"Start_time":获取号码时间},{...}]（*"Timeout"以秒为单位）

2））失败返回值说明：

• ?       parameter_error传入参数错误
• ?       not_login没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token
• ?       account_is_locked账号被锁定
• ?       account_is_stoped账号被停用
• ?       account_is_question_locked账号已关闭
• ?       account_is_ip_stoped账号ip锁定
• ?       message|please try again later访问速度过快，建议休眠100毫秒后再试
• ?       not_found_moblie没有找到手机号
• ?       not_found_project没有找到项目,项目ID不正确
• ?       message|可使用余额不足可使用余额不足
• ?       not_send号码已下线，无法发送
• ?       fail失败
• unknow_error未知错误,再次请求就会正确返回