wenova/microservices-php

PHP SDK for Wenova Microservices SMS/OTP and address APIs.

v0.1.0 2026-05-12 17:02 UTC

Requires

• php: >=8.1
• ext-json: *

MIT

README

Official SDK monorepo for Wenova Microservices integrations.

This repository contains backend SDKs for:

Language	Folder	Status
PHP	php/	Ready for GitHub/local installation
Python	python/	Ready for GitHub/local installation
Ruby	ruby/	Ready for GitHub/local installation
C#	csharp/	Ready for GitHub/local installation
Java	java/	Ready for GitHub/local installation

Install From GitHub

Clone the SDK repository first:

git clone [e-mail]:Wenova-Co-LTD/wenova_microservices_sdk.git
cd wenova_microservices_sdk

Then install or reference the SDK for your language:

# PHP
composer config repositories.wenova-microservices-php path ./php
composer require wenova/microservices-php:@dev

# Python
cd python && pip install -e .

# Ruby
cd ruby && gem build wenova-microservices.gemspec && gem install ./wenova-microservices-0.1.0.gem

# C#
dotnet add package Wenova.Microservices --version 0.1.0

# Java
cd java && mvn package

API Contract

Default API base URL:

https://apimicroservices.wenova.fun

All SDKs support an optional custom base URL and the WENOVA_API_URL environment variable.

SMS/OTP

POST /sms/package

Required fields:

• header
• phoneNumber
• message
• usePackage
• at least one of token or scriptId

Address

Address methods call:

• GET /npm-provinces
• GET /npm-provinces/{id}
• GET /npm-districts/by-province/{provinceId}
• GET /npm-districts/{id}
• GET /npm-vilages/by-district/{districtId}
• GET /npm-vilages/{id}

Required field:

• pluginKey

Optional fields:

• kw
• lang

Verification

Run package build or syntax checks from each language folder before using or publishing.

cd php && composer validate --strict
cd python && python -m compileall wenova_microservices
cd ruby && ruby -c lib/wenova/microservices.rb
cd csharp && dotnet build src/Wenova.Microservices/Wenova.Microservices.csproj
cd java && mvn package

Local Verification Status

Last checked on this machine:

Language	Command	Result
PHP	composer validate --strict and php -l src/*.php	Passed
Python	python -m compileall wenova_microservices	Passed
Ruby	ruby -c lib/wenova/microservices.rb	Passed
C#	dotnet build src/Wenova.Microservices/Wenova.Microservices.csproj	Passed
Java	mvn package	Passed

Registry Publishing

The SDKs are currently available from this GitHub repository. Package registry publishing is a separate future step for Packagist, PyPI, RubyGems, NuGet, and Maven Central.