Shandongjingdong API

Welcome to the Shandongjingdong API documentation. Our API is a RESTful interface.

The API returns JSON-encoded objects. Hash keys and values are case-sensitive and character encoding is in UTF-8. Hash keys may be returned in any random order and new keys may be added at any time. We will do our best to notify our users before removing hash keys from results or adding required parameters.

Rate Limit

By default, you can make up to 60 requests per minute. Requests are associated with the API key, and not with your IP address. The response headers tell you everything you need to know about your current rate limit status

Header name	Description
X-RateLimit-Limit	The maximum number of requests that the consumer is permitted to make in 30 minutes.
X-RateLimit-Remaining	The number of requests remaining in the current rate limit window.
X-RateLimit-Reset	The remaining time in seconds after which the current rate limit window resets.

Hotlinking

Returned image URLs may be used for temporarily displaying search results. However, permanent hotlinking of images (using Pixabay URLs in your app) is not allowed. If you intend to use the images, please download them to your server first. Videos may be embedded directly in your applications. Yet, we recommend storing them on your server.

Error Handling

If an error occurs, a response with propper HTTP error status code is returned. The body of this response contains a description of the issue in plain text. For example, once you go over the rate limit you will receive an HTTP error 429 ("Too Many Requests") with the message "API rate limit exceeded".

Authorization

Authorization is realized through several additional public parameters, as follows:

Param	Description
appid	The app id. You can found the parameter in the profile.
timestamp	This is now seconds from 8:00 on January 1, 1970. Timezone use UTC-0
sign	This is sign. sign=md5([key1]:[value1],[key2]:[value2],appsecret) Key is the request params ansi sort asc exclude sign param. Appsecret is secret, You can found the parameter in the profile.

Proxy List

Request Params

Param	Description
type	The proxy type.
country	The country name.
port	The port num.

Response

This will response JSON array who include proxy list. as follow:

Param	Description
type	The proxy type.
ip	The proxy ip.
port	The proxy port.
timeout	The proxy timeout.
country	The proxy country.
anonymity	The proxy anonymity.