Udostępniamy bezpłatne biblioteki SDK dla najpopularniejszych języków programowania, które znacząco przyspieszają integrację z platformą i upraszczają wdrożenie.
Biblioteki powstały w oparciu o REST API, zapewniając spójność z oficjalnymi interfejsami.
wersja ≥ 8.2
Node.js itp.
wersja ≥ 3.9
.Net ≥ 8.0
wersja ≥ 11
wersja ≥ 1.14
Biblioteka SMS SDK dla języka PHP oparta jest na managerze pakietów Composer w celu poprawnego zarządzania zależnościami. Aby zainstalować SDK i jego zależności dodaj ten pakiet do pliku composer.json:
composer require "postivo/postivo-client"<?php
declare(strict_types=1);
require 'vendor/autoload.php';
use Brick\DateTime\LocalDate;
use Postivo;
use Postivo\Models\Components;
$sdk = Postivo\Client::builder()
->setSecurity(
'<YOUR API ACCESS TOKEN>'
)
->build();
$request = new Components\Shipment(
recipients: new Components\RecipientInline(
name: 'Jan Nowak',
name2: 'Firma testowa Sp. z o.o.',
address: 'ul. Testowa',
homeNumber: '23',
flatNumber: '2',
postCode: '00-999',
city: 'Warszawa',
phoneNumber: '+48666666666',
postscript: 'Komunikat',
customId: '1234567890',
),
documents: [
new Components\DocumentPdf(
fileStream: '<document_1 content encoded to base64>',
fileName: 'document1.pdf',
),
new Components\DocumentPdf(
fileStream: '<document_2 content encoded to base64>',
fileName: 'document2.pdf',
),
],
options: new Components\ShipmentOptions(
predefinedConfigId: 2670,
),
);
$response = $sdk->shipments->dispatch(
request: $request
);
if ($response->shipmentDetails !== null) {
// handle response
}<?php
declare(strict_types=1);
require 'vendor/autoload.php';
use Postivo;
$sdk = Postivo\Client::builder()
->setSecurity(
'<YOUR API ACCESS TOKEN>'
)
->build();
$response = $sdk->shipments->status(
ids: [
'A0043456',
]
);
if ($response->statusDetails !== null) {
// handle response
}<?php
declare(strict_types=1);
require 'vendor/autoload.php';
use Postivo;
$sdk = Postivo\Client::builder()
->setSecurity(
'<YOUR API ACCESS TOKEN>'
)
->build();
$response = $sdk->shipments->cancel(
ids: [
'A0043456',
]
);
if ($response->shipmentCancellations !== null) {
// handle response
}<?php
declare(strict_types=1);
require 'vendor/autoload.php';
use Postivo;
use Postivo\Models\Operations;
$sdk = Postivo\Client::builder()
->setSecurity(
'<YOUR API ACCESS TOKEN>'
)
->build();
$response = $sdk->shipments->documents(
id: 'A0043456',
type: Operations\DocumentType::DispatchCert
);
if ($response->documentResponse !== null) {
// handle response
}<?php
declare(strict_types=1);
require 'vendor/autoload.php';
use Postivo;
$sdk = Postivo\Client::builder()
->setSecurity(
'<YOUR API ACCESS TOKEN>'
)
->build();
$response = $sdk->metadata->list();
if ($response->metadataResponse !== null) {
// handle response
}
Biblioteka SDK dla języka TS może być zainstalowana przy użyciu managerów pakietów npm, pnpm, bun oraz yarn:
npm add @postivo/postivo-clientimport { Client } from "@postivo/postivo-client";
const client = new Client({
bearer: "<YOUR API ACCESS TOKEN>",
});
async function run() {
const result = await client.shipments.dispatch({
recipients: {
name: "Jan Nowak",
name2: "Firma testowa Sp. z o.o.",
address: "ul. Testowa",
homeNumber: "23",
flatNumber: "2",
postCode: "00-999",
city: "Warszawa",
country: "PL",
phoneNumber: "+48666666666",
postscript: "Komunikat",
customId: "1234567890",
},
documents: [
{
fileStream: "<document_1 content encoded to base64>",
fileName: "document1.pdf",
},
{
fileStream: "<document_2 content encoded to base64>",
fileName: "document2.pdf",
},
],
options: {
predefinedConfigId: 2670,
},
});
console.log(result);
}
run();
import { Client } from "@postivo/postivo-client";
const client = new Client({
bearer: "<YOUR API ACCESS TOKEN>",
});
async function run() {
const result = await client.shipments.status({
ids: [
"A0043456",
],
});
console.log(result);
}
run();import { Client } from "@postivo/postivo-client";
const client = new Client({
bearer: "<YOUR API ACCESS TOKEN>",
});
async function run() {
const result = await client.shipments.cancel({
ids: [
"A0043456",
],
});
console.log(result);
}
run();import { Client } from "@postivo/postivo-client";
const client = new Client({
bearer: "<YOUR API ACCESS TOKEN>",
});
async function run() {
const result = await client.shipments.documents({
id: "A0043456",
type: "dispatch_cert",
});
console.log(result);
}
run();import { Client } from "@postivo/postivo-client";
const client = new Client({
bearer: "<YOUR API ACCESS TOKEN>",
});
async function run() {
const result = await client.metadata.list();
console.log(result);
}
run();
Domyślnym managerem pakietów dla Python’a jest PIP, który pozwala na łatwą instalację i zarządzanie pakietami z PyPI za pośrednictwem wiersza poleceń:
pip install postivo-client# Synchronous Example
from postivo_client import Client
with Client(
bearer="<YOUR API ACCESS TOKEN>",
) as client:
res = client.shipments.dispatch(recipients={
"name": "Jan Nowak",
"name2": "Firma testowa Sp. z o.o.",
"address": "ul. Testowa",
"home_number": "23",
"flat_number": "2",
"post_code": "00-999",
"city": "Warszawa",
"country": "PL",
"phone_number": "+48666666666",
"postscript": "Komunikat",
"custom_id": "1234567890",
}, documents=[
{
"file_stream": "<document_1 content encoded to base64>",
"file_name": "document1.pdf",
},
{
"file_stream": "<document_2 content encoded to base64>",
"file_name": "document2.pdf",
},
], options={
"predefined_config_id": 2670,
})
# Handle response
print(res)from postivo_client import Client
with Client(
bearer="<YOUR API ACCESS TOKEN>",
) as client:
res = client.shipments.status(ids=[
"A0043456",
])
# Handle response
print(res)from postivo_client import Client
with Client(
bearer="<YOUR API ACCESS TOKEN>",
) as client:
res = client.shipments.cancel(ids=[
"A0043456",
])
# Handle response
print(res)from postivo_client import Client
with Client(
bearer="<YOUR API ACCESS TOKEN>",
) as client:
res = client.shipments.documents(id="A0043456", type_="dispatch_cert")
# Handle response
print(res)from postivo_client import Client
with Client(
bearer="<YOUR API ACCESS TOKEN>",
) as client:
res = client.metadata.list()
# Handle response
print(res)
Aby dodać pakiet NuGet do projektu .NET użyj polecenia:
dotnet add package Postivousing Postivo;
using Postivo.Models.Components;
using System.Collections.Generic;
var sdk = new Client(bearer: "<YOUR API ACCESS TOKEN>");
Shipment req = new Shipment() {
Recipients = ShipmentRecipients.CreateRecipients(
Recipients.CreateRecipientInline(
new RecipientInline() {
Name = "Jan Nowak",
Name2 = "Firma testowa Sp. z o.o.",
Address = "ul. Testowa",
HomeNumber = "23",
FlatNumber = "2",
PostCode = "00-999",
City = "Warszawa",
PhoneNumber = "+48666666666",
Postscript = "Komunikat",
CustomId = "1234567890",
}
)
),
Documents = ShipmentDocuments.CreateArrayOfDocuments(
new List<Documents>() {
Documents.CreateDocumentPdf(
new DocumentPdf() {
FileStream = "<document_1 content encoded to base64>",
FileName = "document1.pdf",
}
),
Documents.CreateDocumentPdf(
new DocumentPdf() {
FileStream = "<document_2 content encoded to base64>",
FileName = "document2.pdf",
}
),
}
),
Options = Options.CreateShipmentOptions(
new ShipmentOptions() {
PredefinedConfigId = 2670,
}
),
};
var res = await sdk.Shipments.DispatchAsync(req);
// handle responseusing Postivo;
using Postivo.Models.Components;
using System.Collections.Generic;
var sdk = new Client(bearer: "<YOUR API ACCESS TOKEN>");
var res = await sdk.Shipments.StatusAsync(ids: new List<string>() {
"A0043456",
});
// handle responseusing Postivo;
using Postivo.Models.Components;
using System.Collections.Generic;
var sdk = new Client(bearer: "<YOUR API ACCESS TOKEN>");
var res = await sdk.Shipments.CancelAsync(ids: new List<string>() {
"A0043456",
});
// handle responseusing Postivo;
using Postivo.Models.Components;
using Postivo.Models.Requests;
var sdk = new Client(bearer: "<YOUR API ACCESS TOKEN>");
var res = await sdk.Shipments.DocumentsAsync(
id: "A0043456",
type: DocumentType.DispatchCert
);
// handle responseusing Postivo;
using Postivo.Models.Components;
var sdk = new Client(bearer: "<YOUR API ACCESS TOKEN>");
var res = await sdk.Metadata.ListAsync();
// handle response
Wymagana jest wersja JDK 11 lub wyższa. Żeby zainstalować pakiet użyj Gradle:
implementation 'pl.postivo:client:0.0.10'package hello.world;
import java.lang.Exception;
import java.util.List;
import pl.postivo.sdk.Client;
import pl.postivo.sdk.models.components.*;
import pl.postivo.sdk.models.errors.ErrorResponse;
import pl.postivo.sdk.models.operations.ShipmentDispatchResponse;
public class Application {
public static void main(String[] args) throws ErrorResponse, ErrorResponse, Exception {
Client sdk = Client.builder()
.bearer("<YOUR API ACCESS TOKEN>")
.build();
Shipment req = Shipment.builder()
.recipients(ShipmentRecipients.of(Recipients.of(RecipientInline.builder()
.name("Jan Nowak")
.address("ul. Testowa")
.postCode("00-999")
.city("Warszawa")
.name2("Firma testowa Sp. z o.o.")
.homeNumber("23")
.flatNumber("2")
.phoneNumber("+48666666666")
.postscript("Komunikat")
.customId("1234567890")
.build())))
.documents(ShipmentDocuments.of(List.of(
Documents.of(DocumentPdf.builder()
.fileStream("<document_1 content encoded to base64>")
.fileName("document1.pdf")
.build()),
Documents.of(DocumentPdf.builder()
.fileStream("<document_2 content encoded to base64>")
.fileName("document2.pdf")
.build()))))
.options(Options.of(ShipmentOptions.builder()
.predefinedConfigId(2670L)
.build()))
.build();
ShipmentDispatchResponse res = sdk.shipments().dispatch()
.request(req)
.call();
if (res.shipmentDetails().isPresent()) {
// handle response
}
}
}package hello.world;
import java.lang.Exception;
import java.util.List;
import pl.postivo.sdk.Client;
import pl.postivo.sdk.models.errors.ErrorResponse;
import pl.postivo.sdk.models.operations.GetStatusResponse;
public class Application {
public static void main(String[] args) throws ErrorResponse, ErrorResponse, Exception {
Client sdk = Client.builder()
.bearer("<YOUR API ACCESS TOKEN>")
.build();
GetStatusResponse res = sdk.shipments().status()
.ids(List.of(
"A0043456"))
.call();
if (res.statusDetails().isPresent()) {
// handle response
}
}
}package hello.world;
import java.lang.Exception;
import java.util.List;
import pl.postivo.sdk.Client;
import pl.postivo.sdk.models.errors.ErrorResponse;
import pl.postivo.sdk.models.operations.CancelShipmentResponse;
public class Application {
public static void main(String[] args) throws ErrorResponse, ErrorResponse, Exception {
Client sdk = Client.builder()
.bearer("<YOUR API ACCESS TOKEN>")
.build();
CancelShipmentResponse res = sdk.shipments().cancel()
.ids(List.of(
"A0043456"))
.call();
if (res.shipmentCancellations().isPresent()) {
// handle response
}
}
}package hello.world;
import java.lang.Exception;
import pl.postivo.sdk.Client;
import pl.postivo.sdk.models.errors.ErrorResponse;
import pl.postivo.sdk.models.operations.DocumentType;
import pl.postivo.sdk.models.operations.GetDocumentsResponse;
public class Application {
public static void main(String[] args) throws ErrorResponse, ErrorResponse, Exception {
Client sdk = Client.builder()
.bearer("<YOUR API ACCESS TOKEN>")
.build();
GetDocumentsResponse res = sdk.shipments().documents()
.id("A0043456")
.type(DocumentType.DISPATCH_CERT)
.call();
if (res.documentResponse().isPresent()) {
// handle response
}
}
}package hello.world;
import java.lang.Exception;
import pl.postivo.sdk.Client;
import pl.postivo.sdk.models.errors.ErrorResponse;
import pl.postivo.sdk.models.operations.ListMetadataResponse;
public class Application {
public static void main(String[] args) throws ErrorResponse, ErrorResponse, Exception {
Client sdk = Client.builder()
.bearer("<YOUR API ACCESS TOKEN>")
.build();
ListMetadataResponse res = sdk.metadata().list()
.call();
if (res.metadataResponse().isPresent()) {
// handle response
}
}
}
Aby dodać bibliotekę SMS SDK do projektu w Go użyj polecenia:
go get github.com/postivo/go-clientpackage main
import (
"context"
postivo "github.com/postivo/go-client"
"github.com/postivo/go-client/models/components"
"github.com/postivo/go-client/optionalnullable"
"log"
)
func main() {
ctx := context.Background()
s := postivo.New(
postivo.WithSecurity("<YOUR API ACCESS TOKEN>"),
)
res, err := s.Shipments.Dispatch(ctx, components.Shipment{
Recipients: components.CreateShipmentRecipientsRecipients(
components.CreateRecipientsRecipientInline(
components.RecipientInline{
Name: postivo.Pointer("Jan Nowak"),
Name2: optionalnullable.From(postivo.Pointer("Firma testowa Sp. z o.o.")),
Address: postivo.Pointer("ul. Testowa"),
HomeNumber: optionalnullable.From(postivo.Pointer("23")),
FlatNumber: optionalnullable.From(postivo.Pointer("2")),
PostCode: postivo.Pointer("00-999"),
City: postivo.Pointer("Warszawa"),
PhoneNumber: optionalnullable.From(postivo.Pointer("+48666666666")),
Postscript: optionalnullable.From(postivo.Pointer("Komunikat")),
CustomID: optionalnullable.From(postivo.Pointer("1234567890")),
},
),
),
Documents: components.CreateShipmentDocumentsArrayOfDocuments(
[]components.Documents{
components.CreateDocumentsDocumentPdf(
components.DocumentPdf{
FileStream: "<document_1 content encoded to base64>",
FileName: optionalnullable.From(postivo.Pointer("document1.pdf")),
},
),
components.CreateDocumentsDocumentPdf(
components.DocumentPdf{
FileStream: "<document_2 content encoded to base64>",
FileName: optionalnullable.From(postivo.Pointer("document2.pdf")),
},
),
},
),
Options: optionalnullable.From(postivo.Pointer(components.CreateOptionsObjShipmentOptions(
components.ShipmentOptions{
PredefinedConfigID: optionalnullable.From(postivo.Pointer[int64](2670)),
},
))),
})
if err != nil {
log.Fatal(err)
}
if res.ShipmentDetails != nil {
// handle response
}
}
package main
import(
"context"
postivo "github.com/postivo/go-client"
"log"
)
func main() {
ctx := context.Background()
s := postivo.New(
postivo.WithSecurity("<YOUR API ACCESS TOKEN>"),
)
res, err := s.Shipments.Status(ctx, []string{
"A0043456",
})
if err != nil {
log.Fatal(err)
}
if res.StatusDetails != nil {
// handle response
}
}package main
import(
"context"
postivo "github.com/postivo/go-client"
"log"
)
func main() {
ctx := context.Background()
s := postivo.New(
postivo.WithSecurity("<YOUR API ACCESS TOKEN>"),
)
res, err := s.Shipments.Cancel(ctx, []string{
"A0043456",
})
if err != nil {
log.Fatal(err)
}
if res.ShipmentCancellations != nil {
// handle response
}
}package main
import(
"context"
postivo "github.com/postivo/go-client"
"github.com/postivo/go-client/models/operations"
"log"
)
func main() {
ctx := context.Background()
s := postivo.New(
postivo.WithSecurity("<YOUR API ACCESS TOKEN>"),
)
res, err := s.Shipments.Documents(ctx, "A0043456", operations.DocumentTypeDispatchCert)
if err != nil {
log.Fatal(err)
}
if res.DocumentResponse != nil {
// handle response
}
}package main
import(
"context"
postivo "github.com/postivo/go-client"
"log"
)
func main() {
ctx := context.Background()
s := postivo.New(
postivo.WithSecurity("<YOUR API ACCESS TOKEN>"),
)
res, err := s.Metadata.List(ctx)
if err != nil {
log.Fatal(err)
}
if res.MetadataResponse != nil {
// handle response
}
}Skontaktuj się z nami, a udzielimy na nie odpowiedzi.
POSTIVO.PL Sp. z o.o.
ul. Litewska 4B/16
35-302 Rzeszów
tel. +48 17 717 37 60
e-mail: [email protected]
Pn-Pt: 8:00-16:00
So-Nd: Nieczynne
Niniejsza strona wykorzystuje pliki cookies (tzw. ciasteczka) w celach statystycznych, reklamowych oraz funkcjonalnych.
Administratorem danych jest POSTIVO.PL Sp. z o.o., ul. Litewska 4B/16, 35-302 Rzeszów. Szczegółowe informacje dotyczące przetwarzanych danych osobowych znajdują się w Polityce Prywatności.
We may request cookies to be set on your device. We use cookies to let us know when you visit our websites, how you interact with us, to enrich your user experience, and to customize your relationship with our website.
Click on the different category headings to find out more. You can also change some of your preferences. Note that blocking some types of cookies may impact your experience on our websites and the services we are able to offer.
These cookies are strictly necessary to provide you with services available through our website and to use some of its features.
Because these cookies are strictly necessary to deliver the website, refusing them will have impact how our site functions. You always can block or delete cookies by changing your browser settings and force blocking all cookies on this website. But this will always prompt you to accept/refuse cookies when revisiting our site.
We fully respect if you want to refuse cookies but to avoid asking you again and again kindly allow us to store a cookie for that. You are free to opt out any time or opt in for other cookies to get a better experience. If you refuse cookies we will remove all set cookies in our domain.
We provide you with a list of stored cookies on your computer in our domain so you can check what we stored. Due to security reasons we are not able to show or modify cookies from other domains. You can check these in your browser security settings.
We also use different external services like Google Webfonts, Google Maps, and external Video providers. Since these providers may collect personal data like your IP address we allow you to block them here. Please be aware that this might heavily reduce the functionality and appearance of our site. Changes will take effect once you reload the page.
Google Webfont Settings:
Google Map Settings:
Google reCaptcha Settings:
Vimeo and Youtube video embeds:
You can read about our cookies and privacy settings in detail on our Privacy Policy Page.
Polityka prywatności