README

Unofficial PHP SDK for Ohmywishes.

This project is not affiliated with Ohmywishes and is not maintained by them.

Installation

composer require hyperplural/ohmywishes

Quick Start

<?php

declare(strict_types=1);

use Hyperplural\Ohmywishes\Auth\StaticTokenProvider;
use Hyperplural\Ohmywishes\Client\ClientConfig;
use Hyperplural\Ohmywishes\Client\OhMyWishesClient;

$client = new OhMyWishesClient(
    new ClientConfig(),
    new StaticTokenProvider('your-access-token'),
);

$profile = $client->users()->self();

echo $profile->fullName;

If you want to resolve Cloudflare captcha tokens lazily, pass a callback when creating the auth service:

$client->auth(function (string $purpose, array $context): string {
    return getCaptchaTokenSomehow($purpose, $context);
})->requestPhoneNumberConfirmationCode('+79990000000');

If you need raw HTTP payloads instead of DTOs:

$response = $client->raw()->request('GET', '/api/v3/client');
$payload = $response->json();

Documentation

• docs/README.md - documentation entry point
• docs/v2.md - v2 API
• docs/v3.md - v3 API
• docs/public.md - public status API
• docs/api-spec.md - appendix with notes, normalization, and DTO observations

Credits

• Ohmywishes for the product and the public HTTP surface this SDK mirrors.
• The favicon used in this README comes from the public Ohmywishes site favicon.

Support & Contact

For support, questions, or coordination:

• Telegram: @hyperplural

License

MIT. See LICENSE.