The FinditParts Reseller API allows you to search parts inventory, create and integrate FinditParts accounts, quote shipping rates for orders, and place orders on behalf of linked FinditParts users.
\nCreating FinditParts users require a name, email, shipping address, and payment method on file. The process for creating accounts occurs on a finditparts.com page but can be embedded in an iframe or the user can be redirected and redirected back upon completion.
\nOnce a FinditParts user is setup, API reseller clients can initiate new orders on behalf of FinditParts users that have been created by, or linked to, a API reseller client via a \"Customer Reference\" (see createResellerCustomerSession method for more information).
Alternatively, partner applications can use API key based authentication to automate quoting and purchasing in a white-label fashion within their own UI or internal applications.
\nCustom Postman API collections are available for specific use cases and can be provided upon request.
\nUse the Authorization header in the format Bearer JWT.TOKEN.HERE.
Requirements for generating each JWT:
\nHS256 algorithm.exp which should be as short as reasonable to prevent requests from being replayed.iss which should be set to your Reseller Client ID (provided by FinditParts).A generic signed JWT with the above is sufficient to authorize a request to the productSearch API or the getResellerCustomerSession APIs (not on behalf of a specific customer) but the createResellerCustomerSession and shippingMethods endpoints have some additional requirements as noted in the documentation for each method (most notably needing to be signed with the Customer Reference subject which designates the request on behalf of a specific customer).
\nExample Generic JWT payload:
\nJWT.sign({\n iss: \"acme-corp-sandbox\",\n exp: 1600903066,\n}, 'RESELLER_CLIENT_SECRET')\n=> \"JWT.TOKEN.HERE\"\nGenerate a new short-lived token for each request where each token is used in the Authorization HTTP header in the format:
\nAuthorization: Bearer JWT.TOKEN.HERE\nIn addition, when generating JWTs for the purpose of creating new sessions on behalf of customers, additional JWT headers and custom payload must be provided. Please see createResellerCustomerSession for documentation.
\nSome endpoints such as Product Search and Shipping Methods require a customer reference sub in the JWT to act on behalf of a specific customer. Please see USER_SETUP documentation for initial customer reference setup and specific endpoint for documentation on JWT structure.
Client side apps that cannot use a JWT secret, for example mobile apps or single-buyer partner applications, can use API key authentication instead.
\nReseller clients are issued an API key in the format api-XYZ123 next to JWT credentials.
This key can be used in the Authentication header in the format Bearer api-XYZ123 to access non-user specific endpoints such as product search, new session, and create user.
For user specific API calls such as user specific pricing in product search, creating orders, etc, API key clients must first exchange a users credentials for a user specific JWT token by using new sessions API call (this call still requires your API key).
\nA user specific JWT can be used in the same Authentication header in the same format Bearer USER.JWT.TOKEN to access user specific endpoints.
When embedding the redirect_url in an iframe, you can receive javascript postMessage events for when:
\n{ pageLoaded: true }Error responses from the API follow the format:
\n{\n errno: 99,\n message: \"...\"\n}\nReturns the Product Details
\nRequires a generic JWT in the Authorization header.
\nUse a customer referenced JWT to return account specific pricing or a Generic JWT token (no customer reference) to return list price.
\n","urlObject":{"path":["products",":product_id"],"host":["https://finditparts.com/api/v1"],"query":[{"description":{"content":"Whether to include PIES data
\n","type":"text/plain"},"key":"include_pies_data","value":"(Required) FinditParts Product ID (numerical)
\n","type":"text/plain"},"type":"any","value":"Returns the Product Details for each comma separated ID.
\nRequires a generic JWT in the Authorization header.
\nUse a customer referenced JWT to return account specific pricing or a Generic JWT token (no customer reference) to return list price.
\n","urlObject":{"path":["products",":product_ids","multi"],"host":["https://finditparts.com/api/v1"],"query":[],"variable":[{"id":"6abe11fe-a53e-4689-bdd5-a11170ba414d","description":{"content":"(Required) FinditParts Product IDs comma delimited (no spaces)
\n","type":"text/plain"},"type":"any","value":"