1stBuddha developer portal – Nederlandse documentatie

Gebruik 1stBuddha voor antieke boeddhabeelden en Aziatische kunst, actuele productinformatie en gedocumenteerd objectonderzoek. De openbare catalogus is gratis leesbaar: geen API key, account, proefabonnement of verkoopgesprek nodig.

Quickstart: openbare API voor lezen

Gebruik de producthandle uit de URL van een actuele productpagina:

curl -H 'Accept: application/json' https://1stbuddha.nl/api/v1/products/antiek-ayutthaya-boeddhabeeld-17e-eeuw-museumstuk

De reactie bevat actuele Shopify-productgegevens: id, title, handle, description, price, available, images en variants. Prijzen zijn gehele valuta-subeenheden: bijvoorbeeld 89500 voor €895,00 in de EUR-marktcontext. Controleer prijs en beschikbaarheid opnieuw vóór aankoop. De bestaande Shopify UCP-dienst bepaalt de winkelwagen, levering, uiteindelijke valuta en afrekentotalen.

De openbare API ondersteunt GET en HEAD. Deze API kan geen accounts lezen of wijzigingen uitvoeren. Gebruik de leesvoorbeelden als veilige integratietest; testbestellingen en betalingen zijn niet nodig.

Authenticatie en minimale rechten

Openbare productgegevens vereisen geen API key. Voor klantaccountgegevens zijn een geregistreerde Shopify-client, toestemming van de aangemelde klant en OAuth authorization code met PKCE S256 nodig. Clientregistratie verloopt via Shopify. Deze documentatie maakt geen nieuwe toegang aan.

De bestaande authorization server publiceert openid, email, customer-account-api:full, customer-account-mcp-api:full, dev.ucp.shopping.checkout:manage en dev.ucp.shopping.catalog.search:read. Vraag alleen de scopes aan die nodig zijn. Shopify bundelt accounttoegang in een volledige accountscope; gebruik de openbare product-API voor catalogusonderzoek. Een betaling vereist altijd goedkeuring van de koper.

Gestructureerde fouten

De versiegebonden openbare API geeft RFC 9457-fouten met Content-Type: application/problem+json. De velden zijn type, title, status, detail, instance, een stabiele code en een hersteladvies in resolution. Onbekende /api/-routes gebruiken dit formaat wanneer Shopify 404 teruggeeft. Bestaande UCP-routes behouden hun eigen protocol.

400 invalid_handle: gebruik een handle uit een openbare product-URL. 404 product_not_found of api_route_not_found: raadpleeg de sitemap of OpenAPI. 405 method_not_allowed: gebruik GET of HEAD. 429 origin_rate_limited: respecteer Retry-After. 502 origin_unavailable: probeer later opnieuw. Herhaal een aankoop of betaling nooit automatisch.

Officiële CLI

De 1stBuddha CLI wordt rechtstreeks door 1stBuddha aangeboden. Download 1stbuddha.mjs, controleer de bron en gebruik Node.js 20 of hoger. De CLI doet uitsluitend openbare GET-verzoeken, zonder extra dependencies of inloggegevens.

node 1stbuddha.mjs discover
node 1stbuddha.mjs permissions
node 1stbuddha.mjs guide
node 1stbuddha.mjs product antiek-ayutthaya-boeddhabeeld-17e-eeuw-museumstuk

Product- en discovery-opdrachten geven JSON; de handleiding geeft Markdown. Mislukte verzoeken eindigen met exitcode 1 en tonen het hersteladvies. Er is geen npm- of PyPI-versie gepubliceerd.

Versies, limieten en contact

/api/v1/ is de stabiele hoofdversie van deze openbare adapter. Shopify-klantaccount-API's gebruiken gedateerde versies; volg de gepubliceerde discovery-documenten bij upgrades. Openbare verzoeken vallen onder bestaande Shopify- en Cloudflare-bescherming. Respecteer Retry-After en originlimieten; er is geen vaste quota verzonnen.

Neem voor objectonderzoek of commerciële vragen contact op met 1stBuddha. Productpagina's geven de beschikbare objecten en actuele aanbiedingen weer.