# Post Status Queries

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface name: freepublish_get

This interface is used to query the status and details of the release task

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/cgi-bin/freepublish/get?access_token=ACCESS_TOKEN

# Cloud Calls

  • This interface does not support cloud calls

# Third party invocation

  • This interface supports Third Party Platform generation business call.

  • The permission set id to which the interface belongs is: 7

  • When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.

# 2. Request parameters

# Query parametersQuery String parameters

Parameter NametypeRequired to fill inIntroductions
access_tokenstringyesInterface invocation credentials, using access_token , authorizer_access_token

# Request BodyRequest Payload

Parameter NametypeRequired to fill inExampleIntroductions
publish_idstringyes100000001Publish task id

# 3. Return Parameters

# Response Payload

Parameter NametypeIntroductions
publish_idstringPublish task id
publish_statusnumberRelease Status (0: successful, 1: in release, 2: original failure, 3: general failure, 4: platform failure, 5: user deletion of all articles after successful, 6: system blocking all articles after success)
article_idstringSuccessful article_id
article_detailobjectArticle Details
fail_idxnumarrayA failed article number

# Res.article_detailObject Payload

Article Details

Parameter NametypeIntroductions
countnumberReturns the number of articles when the post status is 0 (i.e. successful).
itemobjarrayReturn article details when the post status is 0 (i.e. successful)

# Res.article_detail.item(Array)Object Payload

Return article details when the post status is 0 (i.e. successful)

Parameter NametypeIntroductions
idxnumberThe number corresponding to the article
article_urlstringA permanent link to the text

# 4. Note

There are no special considerations for this interface

# 5. Code examples

# 5.1 Success examples

Example Requests

{
  "publish_id": "100000001"
}

Return an example

{
  "publish_id": "100000001",
  "publish_status": 0,
  "article_id": "ARTICLE_ID",
  "article_detail": {
    "count": 1,
    "item": [
      {
        "idx": 1,
        "article_url": "ARTICLE_URL"
      }
    ]
  },
  "fail_idx": []
}

# 5.2 Examples in Release

Example Requests

{
  "publish_id": "100000001"
}

Return an example

{
  "publish_id": "100000001",
  "publish_status": 1,
  "fail_idx": [1]
}

# 5.3 Examples of original audit failure

Example Requests

{
  "publish_id": "100000001"
}

Return an example

{
  "publish_id": "100000001",
  "publish_status": 2,
  "fail_idx": [
    1,
    2
  ]
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

Error codeError DescriptionSolutions
40001invalid credentialIllegal invoking credentials
40002invalid argumentInvalid Parameters
48001api unauthorizedThe API function is not authorized, please confirm that Official Account / Service Account has obtained the interface, you can view the interface permissions in the "public platform website - developer center page"

# 7. Scope of application

How this interface can be invoked under different account types:
Official Account Service Account
Certification only
  • Authentication only: means that only authenticated accounts are allowed to be invoked by the enterprise entity, and accounts that are not authenticated or do not support authentication cannot be invoked.
  • ✔: The account can call this interface
  • Other account types that are not expressly stated may not be called on this interface without special instructions;