Webapi Versie 7

Deze documentatie biedt een overzicht van onze API's, inclusief instructies voor gebruik, voorbeelden en referentiemateriaal. Of u nu een ervaren ontwikkelaar bent of net begint, deze gids helpt u om snel aan de slag te gaan met onze diensten.

Onze API's zijn ontworpen om te integreren met uw bestaande systemen, waardoor u snel nieuwe functionaliteiten kunt implementeren. We gebruiken RESTful principes en JSON/XML voor data-uitwisseling, wat zorgt voor maximale compatibiliteit en eenvoud.

Belangrijke informatie

Voor het gebruik van onze API is een account van PS in foodservice nodig. Alle API-aanroepen moeten worden geauthenticeerd met een authtoken die na het inloggen verkregen wordt en wordt meegestuurd in de header.

Download Documentatie (PDF)

Swagger Documentatie

Voor een interactieve ervaring met onze API's raden we aan om onze Swagger documentatie te raadplegen. Swagger biedt een visuele interface waarmee u API-endpoints kunt verkennen, parameters kunt specificeren en testverzoeken kunt uitvoeren.

Onze Swagger documentatie wordt regelmatig bijgewerkt om wijzigingen in de API weer te geven en is beschikbaar via de onderstaande link.

http://webapi.psinfoodservice.com/v7/swagger/index.html
Bekijk Swagger

Validatie

Validatie is een essentieel onderdeel van onze API. Het zorgt ervoor dat de data die u verzendt correct en consistent is. Bij elke API-aanroep worden validatieregels toegepast op de invoergegevens.

Als een validatiefout optreedt, retourneert de API een duidelijke foutmelding met details over waar en wat er mis is. Validatiefouten worden geretourneerd met HTTP-statuscode 400.

{
    "isSucceeded": false,
    "executionTime": 71,
    "logisticId": 0,
    "error": [
        {
            "position": "productsheet.logistic.Intrastatcode",
            "errorMessage": "The value for Intrastatcode failed validation function IntrastatCodeValidator"
        }
    ]
}
Bekijk validatie documentatie

Downloads

Hieronder vindt u links naar downloadbare resources, waaronder onze master data in Excel-formaat. Deze bestanden bevatten referentiegegevens die nuttig kunnen zijn bij het ontwikkelen van uw integratie.

Masters

De master data bevat coderingen, referentietabellen en voorbeeldgegevens die u kunt gebruiken als referentie tijdens de ontwikkeling.

Download Masters (Excel)

Developer Packages

Om de integratie met onze API te vereenvoudigen, bieden we kant-en-klare packages voor verschillende programmeeromgevingen. Deze packages bevatten alle benodigde functionaliteit om snel aan de slag te gaan.

NuGet Package (.NET)

Ons NuGet package bevat een volledige client library voor .NET ontwikkelaars. Compatibel met .NET 9.0, 8.0, 7.0, 6.0, .NET Standard 2.0 en .NET Framework 4.6.2, 4.8.1.

Install-Package PSinfoodservice
Download via NuGet

PHP Package (Composer)

Ons PHP package maakt het eenvoudig om de API te integreren in PHP-projecten. Installeerbaar via Composer.

composer require psinfoodservice/psinfoodserviceapi
Download via Composer

NuGet en PHP Packages

Om het integreren met onze API zo eenvoudig mogelijk te maken, bieden we officiële client libraries aan voor verschillende programmeeromgevingen. Deze libraries zorgen voor een consistente en betrouwbare manier om met onze API's te communiceren.

NuGet Package voor .NET

Voor .NET ontwikkelaars bieden we een uitgebreide client library die beschikbaar is via NuGet. Deze package ondersteunt alle .NET platforms, inclusief .NET Core, .NET en .NET Framework.

# Install via Package Manager Console
Install-Package PSinfoodservice

# Install via .NET CLI
dotnet add package PSinfoodservice

# Reference in .csproj
<PackageVersion Include="PSinfoodservice" Version="1.0.1.46" />

Belangrijkste features van ons NuGet package:

  • Volledig type-safe API client
  • Automatische authenticatie
  • Foutafhandeling
  • Retrylogica voor betrouwbare communicatie
  • Volledige ondersteuning voor async/await
  • Compatibel met .NET 9.0, 8.0, 7.0, 6.0, .NET Standard 2.0 en .NET Framework 4.6.2, 4.8.1

PHP Package

Voor PHP projecten bieden we een Composer package die eenvoudig te integreren is in elke PHP-applicatie. Deze package is getest op PHP 8.0 en hoger.

# Install via Composer
composer require psinfoodservice/psinfoodserviceapi

Belangrijkste features van ons PHP package:

  • PSR-18 HTTP client-compatibiliteit
  • Eenvoudige authenticatie
  • Automatische serialisatie en deserialisatie van JSON-data
  • Uitgebreide foutafhandeling

Code Voorbeelden

C#/.NET
PHP
// Instantiate the client
var client = new PSinfoodserviceClient(PSPackage.Domain.PSEnvironment.Preprod);

// Authenticate
var loginResponse = await client.Authentication.Login("your-email@example.com", "your-password");
if (loginResponse.IsSuccess && loginResponse?.Data == true) {
    Console.WriteLine("Authentication successful!");

    // Get product information
    var productSheetResponse = await client.WebApi.GetProductSheet(59, PSPackage.Enum.OutputType.All);
    if (productSheetResponse.IsSuccess) {
        Console.WriteLine($"Product name: {productSheetResponse.Data.Summary.Name.FirstOrDefault(p => p.Language == PSPackage.Dtos.Language.nl).Value}");
    }
}