Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Refurbed MerchantService API

The MerchantService API from Refurbed — 4 operation(s) for merchantservice.

Refurbed MerchantService API is one of 18 APIs that Refurbed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include MerchantService. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 4 operations across 4 paths, and defines 14 schemas. It is described by OpenAPI 2.0, at version 1.0.

Requests are made against the base URL https://api.refurbed.com.

4 operations 4 paths 14 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0
Base URL
https://api.refurbed.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Refurbed MerchantService API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (APIKeyAuth). By default, every request must be authenticated.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

MerchantService 4
POST
/refb.merchant.v1.MerchantService/CreateMerchantAddress
Creates merchant's address
CreateMerchantAddress 1 param → 200default
POST
/refb.merchant.v1.MerchantService/DeleteMerchantAddress
Delete merchant's address
DeleteMerchantAddress 1 param → 200default
POST
/refb.merchant.v1.MerchantService/ListMerchantAddresses
Lists addresses defined for merchant
ListMerchantAddresses 1 param → 200default
POST
/refb.merchant.v1.MerchantService/UpdateMerchantAddress
Updates merchant's address
UpdateMerchantAddress 1 param → 200default

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are MerchantAddress (14 properties), CreateMerchantAddressRequest (12 properties), UpdateMerchantAddressRequest (12 properties), Status (3 properties). Each schema is shown below with its type and property counts.

CountryCode
string
Alpha-2 country codes as specified in ISO 3166-1.
MerchantAddressType
string
Status
object
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](h…
3 properties
ListMerchantAddressesRequest
object
1 property
DeleteMerchantAddressResponse
object
UpdateMerchantAddressResponse
object
1 property
UpdateMerchantAddressRequest
object
12 properties 1 required
DeleteMerchantAddressRequest
object
1 property 1 required
ListMerchantAddressesRequest.Filter
object
1 property
CreateMerchantAddressResponse
object
1 property
ListMerchantAddressesResponse
object
1 property
CreateMerchantAddressRequest
object
12 properties 5 required
Any
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides supp…
1 property
MerchantAddress
object
MerchantAddress is the address from which the merchant dispatches shipments. Used as the merchant's shipping address in the context of shipping label creation.
14 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

refurbed-merchantservice-api-openapi.yml Raw ↑

Other APIs Refurbed publishes across the network.

Refurbed BuybackBidService API
Refurbed BuybackOrderItemService API
Refurbed BuybackOrderService API
Refurbed BuybackProductService API
Refurbed BuybackSupplyboxService API
Refurbed CatalogService API
Refurbed CurrencyService API
Refurbed InstanceService API
Refurbed MarketOfferService API
Refurbed MarketService API
Refurbed OfferService API
Refurbed OrderItemReturnService API