PrestaShop 9 API first user guide

[kpodemski]

This article aims to show the basics of using the new API.

There were some issues I encountered during writing this article:

1. I couldn't access /api-client/{apiClientId} endpoints.
2. I couldn't list products using "{{api_url}}products/search/humm/10/PLN" error:

"If no employee is assigned in the context, cart ID must be provided to this method.".

3. When I delete the customer group, there is no response at all apart from the status code 204 (no content).
4. When I retrieve a resource that doesn't exist, the status is 500, and the HTTP code is 404.
5. No endpoint to list all the customer groups in unfortunate.

[jolelievre]

@kpodemski FYI the n. 3 When I delete the customer group, there is no response at all apart from the status code 204 (no content). is on purpose
What would you expect? There is no data to return since it doesn't exist anymore, I believe it's a common convention fo rest APIs 🤔

[kpodemski]

@jolelievre thanks, in this example I think 204 no content should be all right, when it comes to soft-delete, I guess we should handle status code 200? 🤔

[coffrep]

HI @kpodemski a very great article, thanks so much for putting it together. I went on and added just a few edits and approving on my end.

[jolelievre]

@jolelievre thanks, in this example I think 204 no content should be all right, when it comes to soft-delete, I guess we should handle status code 200? 🤔

We didn't handle soft delete so far but that makes sense, but maybe soft delete will be handled via an update request 🤔 Unless we create a dedicated command for soft delete, but we don't have this kind of command so far AFAIK

[jolelievre]

Thanks @kpodemski

All good for me, maybe you want to improve a few last things (like missing links maybe). Let us know when it's ready if you need another review