Documentation

Build your first integration.

Connect sign-in, check product access and respond to purchases. Start with the quickstart, then find the reference for your next task.

Quickstart llms.txt, for agents

Start here

QuickstartFrom an API key to a verified entitlement in four calls.SDKOne package for identity, entitlements, usage and webhook verification. No dependencies.AuthenticationTwo credentials: a product API key for server-to-server, an OAuth token for acting as a person.

Identity

Sign in with Shin IDOAuth 2.0 authorization code with PKCE, two scopes, and a consent screen that names exactly what you receive.

Access

EntitlementsOne call that answers whether this person may use your product, and why.Usage & Qualified Active DaysThree generic signals. No feature events, no payloads about what happened inside.

Money

Purchases & refundsWhat Buy with Guiru does on your behalf, and the two events you actually handle.WebhooksSix events, one envelope, at-least-once delivery with exponential backoff.Verifying signaturesHMAC-SHA256 over timestamp and raw body, compared in constant time, inside a five-minute window.

Selling

Importing a productPaste a URL; Guiru reads what is already public and you confirm what becomes the listing.GitHub importWhat a repository gives the listing, what it does not, and how a repository stays connected.Selling without the SDKBuy with Guiru works before any integration exists. What each delivery method needs from you.Currencies and pricingPrice in USD, BRL, EUR or GBP; add explicit prices in other currencies; nothing is ever converted for you.Buy with Guiru from your own siteOne link. The price, the checkout, the receipt and the entitlement are Guiru's; the click starts on your page.

Operating

Integration diagnosticsWhat the console can tell you about your integration, and what you can fix from it without asking anyone.Errors & rate limitsWhat each status means, and the budgets that produce a 429.TestingTest keys read real data, write no evidence, and let you force either answer.Mobile APIThe first-party surface the Guiru app talks to. Documented so it is not a mystery, not so you build on it.

Reference

ReferenceEvery public endpoint, its credential and its shape, on one page.Versioning & changesOne version, additive changes, and what counts as breaking.For agentsAn MCP server and a plain-text build, so the agent writing the integration reads the current docs.