[Announcement] New Seller API available

  • @fred
    Amministratore

    178 messaggi

    Belgio

    Hello everyone,

    The new Delcampe Seller API is now available, built on today's standards: an OpenAPI 3.1 contract, JSON over HTTPS, HTTP status codes used as intended, a key sent in a header, signed webhooks.

    Some highlights in the new features:
    - A complete reference with code samples and a Postman collection
    - Errors with real HTTP status codes and stable error codes
    - API keys you can create and revoke yourself
    - Safe retries on item creation
    - Better filters on your sales, such as sold_after to fetch only what sold since your last sync

    Everything, including the migration guide with its call-by-call mapping tables, is at developers.delcampe.net ( Link (https) ).
    It comes with your API Pass, nothing changes in your subscription.

    The /rest API is deprecated as of today and stays fully operational until it is switched off on 5 October 2027. Every /rest response now carries Deprecation and Sunset headers announcing that date. Your legacy keys keep working on /rest; new integrations should use /v1 only.

    Questions or feedback? Feel free to reply in this thread.

    The Delcampe team
  • Servitel

    537 messaggi

    Svizzera

    Hello everyone,

    The new Delcampe Seller API is now available, built on today's standards: an OpenAPI 3.1 contract, JSON over HTTPS, HTTP status codes used as intended, a key sent in a header, signed webhooks.

    Some highlights in the new features:
    - A complete reference with code samples and a Postman collection
    - Errors with real HTTP status codes and stable error codes
    - API keys you can create and revoke yourself
    - Safe retries on item creation
    - Better filters on your sales, such as sold_after to fetch only what sold since your last sync

    Everything, including the migration guide with its call-by-call mapping tables, is at developers.delcampe.net ( Link (https) ).
    It comes with your API Pass, nothing changes in your subscription.

    The /rest API is deprecated as of today and stays fully operational until it is switched off on 5 October 2027. Every /rest response now carries Deprecation and Sunset headers announcing that date. Your legacy keys keep working on /rest; new integrations should use /v1 only.

    Questions or feedback? Feel free to reply in this thread.

    The Delcampe team
    Hi Fred
    unfortunately the link is wrong :)
  • @fred
    Amministratore

    178 messaggi

    Belgio

    Hi Fred
    unfortunately the link is wrong :)
    Hi Servitel, thank you for the feedback. The first link was the new endpoint /v1 but it is not accessible with a browser. I removed it from the post.

    The relevant link is the second one: developers.delcampe.net ( Link (https) )

    Fred
  • Servitel

    537 messaggi

    Svizzera

    Any idea on how the api-key is not accepted ?
    I try the category list
    I pass into the header X-Api-Key and the new test key created
    I use the GET method
    The url called is: Link (https)
    Answer by your system: Full authentication is required to access this resource.

    Where I'm wrong ?

    Thanks
    Roberto
  • Servitel

    537 messaggi

    Svizzera

    Fixed the issue.
    But I have found a great mistake: you say to use "en" as locale for english. but the right code is "uk".
    With "en" the call return an empty result.
  • @fred
    Amministratore

    178 messaggi

    Belgio

    Fixed the issue.
    But I have found a great mistake: you say to use "en" as locale for english. but the right code is "uk".
    With "en" the call return an empty result.
    Nice catch, there was an issue with the locale, the categories are always returned in french

    We'll fix it asap, thanks
  • akacfa

    61 messaggi

    Paesi Bassi

    Hi,
    how to get the API key? When I click on API pass under My Store, the link redirects to the main page.
    I tried from 2 different browsers (Brave and Chrome), different language settings, and same behaviour.
  • @alex
    Amministratore

    11 messaggi

    Belgio

    Hi,
    how to get the API key? When I click on API pass under My Store, the link redirects to the main page.
    I tried from 2 different browsers (Brave and Chrome), different language settings, and same behaviour.
    Hello akacfa,

    Thank you for your message, and sorry for the confusion.

    For security reasons, the API Pass page requires you to have logged in with your password during your current visit, because API keys give full access to your shop. If you were logged in automatically (the "Stay logged" option on the login form), you are redirected to the home page.

    You're right, this isn't clear: nothing tells you why you end up on the home page. We are going to improve this.

    To access your keys in the meantime:
    1. Log out of your Delcampe account.
    2. Log back in with your username and password.
    3. Go straight to My store > API Pass.
    4. Click "Create", choose "Production key (your account)" as the key type, then confirm.

    Copy the key right away: it is only displayed once. If you lose it, you can revoke it and create a new one.

    If you already had keys for the old /rest API, they are listed at the bottom of the same page and will keep working until 5 October 2027.

    Until this is improved, if you are redirected to the home page again, simply log out and log back in.

    Developer documentation: Link (https)

    Best regards,
    Alex