POST Seller Review Sample Applications
Seller Review Sample Applications Shop Required scope: seller.affiliate_collaboration.write This API allows the seller to approve or reject the creator's sample application in an open collaboration. When rejecting an application, the seller must provide a specific reason. This API facilitates the management of sample applications by giving sellers the ability to review and update applications according to their criteria and requirements. Version 202507
POST/affiliate_seller/202507/sample_applications/{application_id}/review
Request
Path
| Properties | Type | Description |
|---|---|---|
| application_id Required | string | The unique id of sample request application ID |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| review_result Required | string | The audit action to be taken on a sample application record by the seller. The field accepts one of four enumerated values:- APPROVE: Approves the sample application.- REJECT: Rejects the sample application.This field allows the seller to specify the desired operation to manage the sample application record effectively. |
| reject_reason | string | The reason why a seller rejected a creator's sample application. The possible enumerated values are:- NOT_MATCH: The creator does not meet the seller's collaboration requirements.- OFFLINE: The product has been taken offline.- OUT_OF_STOCK: The product is temporarily out of stock.- OTHER: Any other reason not covered by the above categories.Required if the review_result is set to REJECTThis field allows the seller to specify the reason for rejecting a sample application, providing clarity to the creator regarding the rejection. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678curl-X POST 'https://open-api.tiktokglobalshop.com/affiliate_seller/202507/sample_applications/8070747592760922552/review?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "review_result": "APPROVE", "reject_reason": "NOT_MATCH"}'
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
View common error codes
| Code | Message | | --- | --- | | 16022020 | seller has no permission to operate agency's sample request |
Is this content helpful?Helpful
Not Helpful
PreviousNext