Mesh API
Overview
The Mesh API provides utility services including email verification, file upload, SMS sending, translation, barcode generation, address verification, UPC barcode management, and currency exchange services.
Base Endpoint: /mesh
API Endpoints
1. Email Verification
Verify email address format and deliverability.
Endpoint: POST /mesh/emailcheck
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| String | Yes | Email address to verify |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/emailcheck" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "email=user@example.com"Response:
{
"code": 200,
"msg": "Request successful",
"data": {
"succeed": true,
"msg": "邮件验证成功"
}
}2. File Upload (Base64)
Upload files using base64 encoding.
Endpoint: POST /mesh/file/base64/upload
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing file base64 data and optional channel |
| - file | String | Yes | Base64 encoded file data with data URI prefix |
| - channel | String | No | Storage channel (default: auto) |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/file/base64/upload" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"file\": \"data:image/png;base64,iVBORw0KGgo...\", \"channel\": \"auto\"}"3. File Upload (Multipart)
Upload files using multipart form data.
Endpoint: POST /mesh/uploader
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| file | File | Yes | Multipart file |
| channel | String | Yes | Storage channel (primary, auto, etc.) |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/uploader" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-F "file=@document.pdf" \
-F "channel=auto"4. Human Segmentation (Image Matting)
Remove background from images.
Endpoint: POST /mesh/humansegment
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing URL |
| - url | String | Yes | Image URL to process |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/humansegment" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"url\": \"https://example.com/photo.jpg\"}"5. Send SMS
Send SMS messages through SMS gateway.
Endpoint: POST /mesh/sms
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing SMS parameters |
| - route | String | Yes | Gateway route identifier |
| - phoneNumber | String | Yes | Destination phone number |
| - message | String | Yes | SMS message content |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/sms" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"route\": \"default\", \"phoneNumber\": \"+14155551234\", \"message\": \"Hello!\"}"6. Send Nexmo SMS
Send SMS messages through Nexmo/Vonage gateway.
Endpoint: POST /mesh/nexmo/sms
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing SMS parameters |
| - from | String | Yes | Sender ID |
| - to | String | Yes | Destination phone number |
| - message | String | Yes | SMS message content |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/nexmo/sms" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"from\": \"Company\", \"to\": \"+14155551234\", \"message\": \"Hello!\"}"7. Text Translation
Translate text between languages with database caching.
Endpoint: POST /mesh/translate
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing translation parameters |
| - text | String | Yes | Text to translate |
| - target | String | Yes | Target language code |
| - source | String | No | Source language code (auto-detect if not provided) |
| - channel | String | No | Translation provider (default: ai) |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/translate" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"text\": \"Hello World\", \"target\": \"zh\", \"source\": \"en\"}"8. Send Email Notification
Send notification emails with support for both JSON and direct parameter formats.
Endpoint: POST /mesh/emailnotify
Parameters (Format 1 - JSON via bizContent):
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing email parameters |
| - to | String | Yes | Recipient email address |
| - subject | String | Yes | Email subject |
| String | Yes | Email body content (HTML supported) |
Parameters (Format 2 - Direct Parameters):
| Parameter | Type | Required | Description |
|---|---|---|---|
| to | String | Yes | Recipient email address |
| subject | String | Yes | Email subject |
| String | Yes | Email body content (HTML supported) |
Request (JSON Format):
curl -X POST "https://api.alaikis.com/std/mesh/emailnotify" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"to\": \"user@example.com\", \"subject\": \"Welcome\", \"email\": \"<h1>Hello!</h1>\"}"Request (Direct Parameters):
curl -X POST "https://api.alaikis.com/std/mesh/emailnotify" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "to=user@example.com" \
-d "subject=Welcome" \
-d "email=<h1>Hello!</h1>"9. Product Information Collection
Collect detailed product information from e-commerce platforms.
Endpoint: POST /mesh/product/detail
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing product URL and channel |
| - channel | String | Yes | Platform identifier (amazon, ebay, etc.) |
| - url | String | Yes | Product page URL |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/product/detail" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"channel\": \"amazon\", \"url\": \"https://amazon.com/dp/...\"}"10. UPC Barcode Import
Batch import UPC barcodes into the system.
Endpoint: POST /mesh/upc/bluk/import
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing UPC codes |
| - upcs | String | Yes | Semicolon-separated UPC codes |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/upc/bluk/import" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"upcs\": \"012345678901;012345678902\"}"11. Get UPC Barcodes
Retrieve available unused UPC barcodes.
Endpoint: POST /mesh/upc/get
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing pagination parameters |
| - page | Integer | No | Page number (default: 1) |
| - number | Integer | No | Number per page (default: 20) |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/upc/get" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"page\": 1, \"number\": 50}"12. Mark UPC as Used
Mark UPC barcodes as used/unavailable.
Endpoint: POST /mesh/upc/markused
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing UPC ID |
| - upcId | Integer | Yes | UPC database identifier |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/upc/markused" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"upcId\": 12345}"13. Currency Exchange Rate
Get current currency exchange rates with Redis caching.
Endpoint: POST /mesh/forex/getcurr
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing currency parameters |
| - from | String | Yes | Source currency code |
| - to | String | Yes | Target currency code |
| - money | Decimal | No | Amount to convert (default: 1) |
| - anchor_currency | String | No | Anchor currency (default: CNY) |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/forex/getcurr" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"from\": \"USD\", \"to\": \"EUR\", \"money\": 100}"14. Language Detection
Detect language of input text.
Endpoint: POST /mesh/language/detect
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing text |
| - text | String | Yes | Text to analyze |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/language/detect" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"text\": \"Hello World\"}"15. Douyin Shipper Code
Query Douyin (TikTok) shipper codes.
Endpoint: POST /mesh/douyin/shipper/code
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing name |
| - name | String | Yes | Shipper name to search |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/douyin/shipper/code" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"name\": \"顺丰\"}"16. Address Verification
Verify address components against zone database.
Endpoint: POST /mesh/address/verify
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing address data |
| - countryCode | String | Yes | Country code |
| - province | String | Yes | State/province name |
| - city | String | Yes | City name |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/address/verify" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"countryCode\": \"US\", \"province\": \"California\", \"city\": \"Los Angeles\"}"17. Address Fingerprint
Generate MD5 fingerprint for address zone hierarchy.
Endpoint: POST /mesh/address/figure
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing zone ID |
| - id | Integer | Yes | Zone database ID |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/address/figure" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"id\": 1234}"18. Zone/State Information
Query zone hierarchy information.
Endpoint: POST /mesh/address/state
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing address data |
| - countryCode | String | Yes | Country code |
| - province | String | No | State/province name |
| - city | String | No | City name |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/address/state" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"countryCode\": \"US\", \"province\": \"California\"}"19. Country Information by Name
Retrieve country information by country name.
Endpoint: POST /mesh/address/country/inforbyname
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| bizContent | String | Yes | JSON containing country name |
| - country | String | Yes | Country name |
Request:
curl -X POST "https://api.alaikis.com/std/mesh/address/country/inforbyname" \
-H "X-API-Key: your_api_key" \
-H "X-API-Secret: your_api_secret" \
-d "bizContent={\"country\": \"United States\"}"Rate Limiting
- Email Verification: 500 requests/hour
- File Upload: 100 requests/hour (10MB max)
- Translation: 10000 characters/hour
- SMS: 500 messages/hour
- UPC Operations: 20