Get A Season

Retrieve a Product Collection

This API allows an external system to retrieve the details of a specific product collection registered in the 4ws.suite platform using its unique SEASON_CODE.

Actors

API Client: The system or user initiating the request.

4ws.trade: The backend system that processes the request.

Main Success Scenario

The API client sends a GET request with a valid SEASON_CODE.

The platform retrieves and returns the details of the specified collection.

Response Example

Alternate Flows

Authentication Error: If the client does not provide valid credentials, an error response is returned.

Invalid SEASON_CODE: If the specified code does not exist, an error response is returned.

Error Example

Rate Limiting: If the API rate limits are exceeded, the client must respect the retry interval indicated in the response headers Rate Limits.

Sequence Diagram

Best Practices

Please refer to Best Practices for Error Handling in External System for best practices on implementation.

Code Examples in Node.js

Responses

🟢200POST/PATCH/DELETE Errore record non trovato

application/json

Body

Example

{
    "seasons": [
        {
            "season_code": "string",
            "description_it": "string",
            "description_en": "string",
            "description_de": "string",
            "description_fr": "string",
            "description_es": "string",
            "description_zh": "string",
            "description_pt": "string",
            "description_ru": "string",
            "description_ja": "string",
            "description_ar": "string",
            "year": 2024,
            "season": "1"
        }
    ]
}

Retrieve a Product Collection

Actors

Main Success Scenario

Alternate Flows

Sequence Diagram

Code Examples in Node.js

Request

Request Code Samples

Responses

Get A Season

Retrieve a Product Collection#

Actors#

Main Success Scenario#

Alternate Flows#

Sequence Diagram#

Code Examples in Node.js#

Request

Request Code Samples

Responses

Retrieve a Product Collection

Actors

Main Success Scenario

Alternate Flows

Sequence Diagram

Code Examples in Node.js