Open Platform

Use an API key to securely read your own account profile, orders and feedback from the tools you already use.

A developer writing code

API credentials

An API key grants access to the open API. Every key belongs to your account and can only read your own profile, orders and feedback.

Loading credentials…

API reference

The open API is read-only. Every endpoint is a GET request authenticated with the X-API-Key header.

Authentication

Send your API key in the request header. The server stores only a hash of the key and cannot recover the plaintext.

Header
X-API-Key
curl "https://data.kuaiyizhi.cn/api/open/v1/me" \
  -H "X-API-Key: ky_live_<your-key>"

curl "https://data.kuaiyizhi.cn/api/open/v1/orders?page=1&pageSize=20" \
  -H "X-API-Key: ky_live_<your-key>"

Endpoints

  • GET/api/open/v1/me

    Returns your account ID, email, email verification state, account status, signup time and last login time.

  • GET/api/open/v1/orders

    Returns order ID, course ID, amount, status, payment method and timestamps in reverse chronological order. Transaction IDs and prepay data are omitted.

  • GET/api/open/v1/feedbacks

    Returns the feedback you submitted with its status and any administrator reply. Internal metadata and page URLs are omitted.

Pagination and filters

The list endpoints are paginated. The feedback endpoint additionally supports filtering by type and status.

ParameterApplies toDescription
pageorders, feedbacksPage number, defaults to 1.
pageSizeorders, feedbacksItems per page, defaults to 20, range 1 to 100.
typefeedbacksFeedback type: bug, feature, suggestion, question, other.
statusfeedbacksFeedback status: pending, reviewed, resolved, closed.

Response format

On success, data holds the result array and a pagination object. On failure the response carries success and error.

{
  "success": true,
  "data": {
    "orders": [ /* … */ ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalCount": 42,
      "totalPages": 3,
      "hasNextPage": true,
      "hasPrevPage": false
    }
  }
}

Error codes

  • 400Pagination or filter parameters are invalid.
  • 401The key is missing, invalid or revoked.
  • 403The account is unavailable.