当前位置：首页 > news >正文

美客多接口协议学习

news 2026/5/12 18:30:45

授权流程：

授权url:

https://global-selling.mercadolibre.com/authorization?response_type=code&client_id=$APP_ID&redirect_uri=$YOUR_URL
获取token
url:

curl -X POST -H 'accept: application/json' -H 'content-type: application/x-www-form-urlencoded' https://api.mercadolibre.com/oauth/token?grant_type=authorization_code&client_id=$APP_ID&client_secret=$CLIENT_SECRET&code=$TG_CODE&redirect_uri=$REDIRECT_URL


返参：

{"access_token": "APP_USR-5387223166827464-090515-8cc4448aac10d5105474e135355a8321-8035443","token_type": "bearer","expires_in": 10800,"scope": "offline_access read write","user_id":8035443,"refresh_token": "TG-5b9032b4e4b0714aed1f959f-8035443"
}
刷新token
url:

curl -X POST https://api.mercadolibre.com/oauth/token?grant_type=refresh_token&client_id=$APP_ID&client_secret=$SECRET_KEY&refresh_token=$REFRESH_TOKEN

1. 获取订单

url: https://api.mercadolibre.com/marketplace/orders/$ORDER_ID

请求方式： get

返参：

{"id": 2000003508419013,"date_created": "2020-01-31T18:03:35.000-04:00","date_closed": "2020-01-31T18:03:36.000-04:00","last_updated": "2020-01-31T18:03:36.000-04:00","manufacturing_ending_date": null,"feedback": {"sale": null,"purchase": null},"mediations": [],"comments": null,"pack_id": null,"pickup_id": null,"order_request": {"return": null,"change": null},"fulfilled": null,"paid_amount": 15.1,"coupon": {"id": null,"amount": 0},"expiration_date": "2020-05-10T18:03:36.000-04:00","order_items": [{"item": {"id": "MLM754639529","title": "Elemento De Prueba - Para Pruebas De Carga","category_id": "MLM71792","variation_id": null,"seller_custom_field": null,"variation_attributes": [],"condition": "new","seller_sku": null,"parent_item_id": "CBT910504819"},"quantity": 1,"unit_price": 15.1,"full_unit_price": 15.1,"currency_id": "USD","manufacturing_days": null,"sale_fee": 2.64,"base_exchange_rate": 19.25}],"currency_id": "USD","payments": [{"id": 5855860136,"order_id": 2000003508419013,"payer_id": 441782523,"collector": {"id": 481240836},"card_id": 8738685222,"site_id": "MLM","reason": "Elemento De Prueba - Para Pruebas De Carga","payment_method_id": "amex","currency_id": "USD","installments": 1,"issuer_id": "157","atm_transfer_reference": {"company_id": null,"transaction_id": "1234567"},"coupon_id": null,"activation_uri": null,"operation_type": "regular_payment","payment_type": "credit_card","available_actions": ["refund"],"status": "approved","status_code": null,"status_detail": "accredited","transaction_amount": 15.1,"taxes_amount": 0,"shipping_cost": 0,"coupon_amount": 0,"overpaid_amount": 0,"total_paid_amount": 15.1,"installment_amount": 15.1,"deferred_period": null,"date_approved": "2020-01-31T18:03:36.000-04:00","authorization_code": "1234567","transaction_order_id": null,"date_created": "2020-01-31T18:03:36.000-04:00","date_last_modified": "2020-01-31T18:03:36.000-04:00"}],"shipping": {"id": 28237306862},"status": "paid","status_detail": {"code": "","description": null},"buyer": {"id": 441782523,"nickname": "TESTY0DT2NRL","last_name": "Test","first_name": "Test",},"seller": {"id": 481240836,},"taxes": {"amount": 0,"currency_id": "USD"}"context": {"channel": "marketplace","site": "MLM","flows": ["cbt"],"application": "purchases-api"}
}
2. 买家发消息

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST https://api.mercadolibre.com/marketplace/messages/packs/$ORDER_ID

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST http://api.mercadolibre.com/marketplace/messages/packs/2315686468-H 'content-type: application/json' \-d '{"text": "More test message","text_translated": "","attachments": ["471826944_ba20cdf4-26b4-4c21-a689-5eabe271ddb3.png","523130418_10f6b123-5ec2-44dc-b611-e347098331a2.png"]
}

3. 拉取消息

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/messages/packs/$ORDER_ID

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/messages/packs/2315686468?limit=2&offset=1
返参

{"paging": {"limit": 1,"offset": 0,"total": 1},"conversation_status": {"claim_ids": null,"shipping_id": null,"status": "active","status_date": "2020-02-26T17:37:42Z","status_update_allowed": false,"substatus": null},"messages": [{"id": "2d45a5ad186041659e9a608f0c109dff","site_id": "MLM","client_id": 1344270061107690,"from": {"user_id": 523132944,"name": "TESTNICOCBT TESTNICOCBT"},"to": {"user_id": 441782523,"name": "Test Test"},"status": "available","subject": null,"text": "This a message to buyer","message_date": {"received": "2020-03-13T15:14:10Z","available": "2020-03-13T15:14:10Z","notified": null,"created": "2020-03-13T15:14:10Z","read": null},"message_moderation": {"status": "clean","reason": null,"source": "online","moderation_date": "2020-03-13T15:14:10Z"},"message_attachments": [{"filename": "471826944_ba20cdf4-26b4-4c21-a689-5eabe271ddb3.png","original_filename": "FileName.png","type": "image/png","size": 536766,"potential_security_threat": false,"creation_date": "2020-03-13T15:14:10Z"},{"filename": "523130418_10f6b123-5ec2-44dc-b611-e347098331a2.png","original_filename": "FileName.png","type": "image/png","size": 536766,"potential_security_threat": false,"creation_date": "2020-03-13T15:14:10Z"}],"message_resources": [{"id": "2315686468","name": "packs"},{"id": "523132944","name": "sellers"}],"conversation_first_message": false,"text_translated": "Este es un mensaje para el comprador"}]
}
关键参数解释
from: message sender.
user_id: user id who sent message.
to: message recipient.
user_id: user id who received message.
text: message text.
attachments: attached files.
site_id: Mercado Libre México, Brazil, Colombia, Chile (MLM, MLB, MCO, MLC) site

4. 获取物流

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' -X GET https://api.mercadolibre.com/marketplace/shipments/40531399184

返参：

{"id": 40531399184,"status": "ready_to_ship","substatus": "printed","declared_value": 15.1,"currency_id": "USD","date_created": "2021-04-21T18:07:25.000-04:00","last_updated": "2021-04-26T18:24:06.000-04:00","tracking_number": "MMXQP014735497E","tracking_method": "CBT MA","origin": {"sender_id": 526127536,"shipping_address": {"address_id": 1087531691,"address_line": "XXXXXXX","street_name": "XXXXXXX","street_number": "XXXXXXX","comment": null,"zip_code": "XXXXXXX","city": {"id": "TUxNQ0NVQTMwNDU","name": "Cuautitlan Izcalli"},"state": {"id": "MX-MEX","name": "Estado De México"},"country": {"id": "MX","name": "Mexico"},"neighborhood": {"id": null,"name": "Cuautitlan Izcalli"},"municipality": {"id": null,"name": null},"agency": {"agency_id": null,"carrier_id": null,"description": null,"open_hours": null,"phone": null,"type": null},"types": ["billing","default_selling_address","shipping"],"latitude": 0,"longitude": 0,"geolocation_type": "APPROXIMATE","geolocation_last_updated": "2020-02-12T13:50:08Z","geolocation_source": "google-maps","delivery_preference": ""},"type": "selling_address"},"destination": {"type": "buying_address","receiver_id": 650079057,"receiver_name": "Mara asas","receiver_phone": "XXXXXXX","comments": "","shipping_address": {"address_id": 1132588531,"address_line": "lalalalala 12312","street_name": "lalalalala","street_number": "12312","comment": "Referencia: asdasd","zip_code": "01030","city": {"id": "TUxNQ0FMVjY3MDg","name": "Alvaro Obregón"},"state": {"id": "MX-DIF","name": "Distrito Federal"},"country": {"id": "MX","name": "Mexico"},"neighborhood": {"id": null,"name": "Axotla"},"municipality": {"id": null,"name": null},"agency": {"agency_id": null,"carrier_id": null,"description": null,"open_hours": null,"phone": null,"type": null},"types": ["default_buying_address"],"latitude": 19.355034,"longitude": -99.174821,"geolocation_type": "ROOFTOP","geolocation_last_updated": "2020-09-23T20:17:30Z","geolocation_source": "google-maps","delivery_preference": "business"}},"dimensions": {"height": 3,"length": 45,"weight": 345,"width": 33},"external_reference": null,"lead_time": {"option_id": 721103001,"shipping_method": {"id": 501645,"type": "standard","name": "Envío internacional","deliver_to": "address"},"currency_id": "USD","cost": 0,"list_cost": 0,"cost_type": "free","service_id": 721,"estimated_delivery_time": {"type": "known_frame","date": "2021-05-13T00:00:00.000-05:00","unit": "hour","offset": {"date": "2021-05-20T00:00:00.000-05:00","shipping": 120},"time_frame": {"from": "","to": ""},"pay_before": "2021-04-22T00:00:00.000-05:00","shipping": 312,"handling": 72,"schedule": null}},"source": {"site_id": "MLM"},"logistic": {"mode": "me2","type": "drop_off","direction": "forward"},"tags": ["test_shipment"]
}