OJS 3.5 .NET Client

Tech stack

Visual Basic .NET

.NET 10

HttpClient

System.Text.Json

NuGet

Overview

A .NET client for the Open Journal Systems (OJS) 3.5 REST API. It is written in VB.NET and works from any .NET language, including C#, F# and PowerShell. It covers every public OJS 3.5 endpoint: submissions, publications, contributors, files, decisions, reviews, issues, sections, users, journals, DOIs, statistics and more.

Highlights

Typed models with enums for OJS constants and multilingual values
Handles the PHP backend's quirks: string numbers, date formats, empty arrays and responses that differ from the OpenAPI document
Automatic paging, IAsyncEnumerable streaming and typed exceptions with validation messages
File uploads and downloads, and CSV statistics
Raw PHP-style JSON such as "stageId": "5" becomes typed values like WorkflowStage.Production
Tested against live OJS 3.5 journals
No dependencies beyond System.Net.Http and System.Text.Json

Usage

Install the Ojs.Api.Client NuGet package (prerelease). You need an OJS API key, and the server must have api_key_secret set in config.inc.php. A minimal example in VB.NET (the same API works from C# and F#):

Using ojs As New OjsClient(New OjsClientOptions With {
    .BaseUrl = "https://journals.example.com",
    .JournalPath = "jpk",
    .ApiToken = Environment.GetEnvironmentVariable("OJS_TOKEN")})

    Dim current = Await ojs.Issues.GetCurrentAsync()
    Console.WriteLine(current.Identification)
End Using

Set UseIndexPhp = True if the journal's URLs contain index.php. Package: Ojs.Api.Client on NuGet. More notes: OJS 3.5 Quirks.

OJS 3.5 .NET Client

Overview

Highlights

Usage

Other projects

Kindroid.Library

Bio3SourcenextSaveEditor