README

Official SDK monorepo for Wenova Microservices integrations.

This repository contains backend SDKs for:

Install From GitHub

Clone the SDK repository first:

git clone git@github.com: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:

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.