php-sdk-usagelisted
Install: claude install-skill suqo-ai/suqo-claude-plugins
# SUQO PHP SDK — usage
`suqo/sdk-php`, namespace `Suqo\`, PHP 8.1+, extensions `curl`, `json`, `hash`.
No runtime Composer dependencies.
```bash
composer require suqo/sdk-php
```
## Workflow
1. **Name the task** — checkout flow, subscription dashboard, webhook endpoint,
cancellation route, sync job.
2. **Load only the reference you need** from `references/`. Never load them all.
`references/api-surface.md` is the authority on signatures; load it before
writing any SDK call.
3. **Start from a template** in `templates/` when one is close, rather than
writing from scratch.
4. **Write against documented methods only.** If a reference does not cover
something, say so — do not invent a method, parameter or property. The
surface is small and closed: nine callable operations, three of which throw.
5. **Verify** — `php -l` every file written, then run the project's own test or
lint command. If the project has a sandbox key available, exercise the code
for real; otherwise say plainly that it was not run against the API.
## The whole callable surface
| Call | Returns |
| --- | --- |
| `new SuqoClient(...)` | `SuqoClient` |
| `$suqo->products->list(page:, pageSize:, cancellation:)` | `Page<Product>` |
| `$suqo->products->autoPaging(...)` | `Generator<int, Product>` |
| `$suqo->subscriptions->list(...)` | `SubscriptionPage` |
| `$suqo->subscriptions->autoPaging(...)` | `Generator<int, Subscription>` |
| `$suqo->subscriptions->create(CreateSubscriptionParams,