Remote Procedure Calls (RPC) let you work on your local machine as if you where connected directly to our servers. We predefined functions for you that you can use with predefined parameters as it serves you best. You don't need any knowledge of the individual endpoints anymore or which methods to use. You can generate the actual code from the protobuffer files in your desired language, then import it and then call the function.
We suggest to just play around with the generated API client and our sandbox a bit and you will see that this is very convenient.
With gRPC you cannot use standard cURL, if you want to fire up gRPC requests yourself you can use grpcurl for example (or one of various GUI tools). Example requests and response to retrieve all available site markets from your sandbox:
grpcurl --import-path refurbed_merchant_api --proto refurbed_merchant_api/refb/merchant/v1/services/market_service.proto -H \
'Authorization: Plain {TOKEN}' -d \
'{"filter":{"type":{"any_of":["COUNTRY"]},"is_site":{"value":true}},"sort":{"by":"NAME"}}' \
api.refurbed.com:443 \
refb.merchant.v1.MarketService.ListMarkets
=>
{
"markets": [
{
"code": "at",
"isSite": true,
"type": "COUNTRY",
"name": "Austria",
"currencyCode": "EUR"
},
{
"code": "dk",
"isSite": true,
"type": "COUNTRY",
...We do have an example for the Python client in the README. It just uses the generated client. We don't have more examples at the moment as they are just 1:1 the methods and types from the client. The beauty of this system is that you do not need to mess around with low-level details like HTTP requests or serialisation yourself. This is all done for you by the client.
If you use the HTTP Version of the API regular cURL can be used. Just be aware that it is a POST-only API.