ApimaticUspsSdk 1.0.0

Getting Started with USPS API

Introduction

Contact Us: USPS API Support | Terms of Service

The Addresses API validates and corrects address information to improve package delivery service and pricing. This suite of APIs provides different utilities for addressing components. The ZIP Code™ lookup finds valid ZIP Code™(s) for a City and State. The City/State lookup provides the valid cities and states for a provided ZIP Code™. The Address Standardization API validates and standardizes USPS® domestic addresses, city and state names, and ZIP Code™ in accordance with USPS® addressing standards. The USPS® address standard includes the ZIP + 4®, signifying a USPS® delivery point, given a street address, a city and a state.

Install the Package

If you are building with .NET CLI tools then you can also use the following command:

dotnet add package ApimaticUspsSdk --version 1.0.0

You can also view the package at: https://www.nuget.org/packages/ApimaticUspsSdk/1.0.0

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

The API client can be initialized as follows:

Code-Based Initialization

using Microsoft.Extensions.Logging;
using System.Collections.Generic;
using UspsApi.Standard;
using UspsApi.Standard.Authentication;
using UspsApi.Standard.Models;

namespace ConsoleApp;

UspsApiClient client = new UspsApiClient.Builder()
    .OauthAuthorizationCodeCredentials(
        new OauthAuthorizationCodeModel.Builder(
            "OAuthClientId",
            "OAuthClientSecret",
            "OAuthRedirectUri"
        )
        .OauthScopes(
            new List<OauthScopeOauthAuthorizationCode>
            {
                OauthScopeOauthAuthorizationCode.Addresses,
                OauthScopeOauthAuthorizationCode.Adjustments,
            })
        .Build())
    .OauthClientCredentialsCredentials(
        new OauthClientCredentialsModel.Builder(
            "OAuthClientId",
            "OAuthClientSecret"
        )
        .OauthScopes(
            new List<OauthScopeOauthClientCredentials>
            {
                OauthScopeOauthClientCredentials.Addresses,
                OauthScopeOauthClientCredentials.Adjustments,
            })
        .Build())
    .BasicAuthCredentials(
        new BasicAuthModel.Builder(
            "Username",
            "Password"
        )
        .Build())
    .BearerTokenAuthCredentials(
        new BearerTokenAuthModel.Builder(
            "AccessToken"
        )
        .Build())
    .HttpClientConfig(httpClientConfig =>
        httpClientConfig.Timeout(TimeSpan.FromSeconds(100)))
    .Environment(UspsApi.Standard.Environment.Production)
    .LoggingConfig(config => config
        .LogLevel(LogLevel.Information)
        .RequestConfig(reqConfig => reqConfig.Body(true))
        .ResponseConfig(respConfig => respConfig.Headers(true))
    )
    .Build();

Configuration-Based Initialization

using UspsApi.Standard;
using Microsoft.Extensions.Configuration;

namespace ConsoleApp;

// Build the IConfiguration using .NET conventions (JSON, environment, etc.)
var configuration = new ConfigurationBuilder()
    .AddJsonFile("config.json")
    .AddEnvironmentVariables() // [optional] read environment variables
    .Build();

// Instantiate your SDK and configure it from IConfiguration
var client = UspsApiClient
    .FromConfiguration(configuration.GetSection("UspsApi"));

See the Configuration-Based Initialization section for details.

Environments

The SDK can be configured to use a different environment for making API calls. Available environments are:

Fields

Authorization

This API uses the following authentication schemes.

• OAuth_authorization_code (OAuth 2 Authorization Code Grant)
• OAuth_client_credentials (OAuth 2 Client Credentials Grant)
• BasicAuth (Basic Authentication)
• BearerTokenAuth (OAuth 2 Bearer token)

List of APIs

• Listener URL Specification
• Resources
• Files

SDK Infrastructure

Configuration

• Configuration-Based Initialization
• HttpClientConfiguration
• HttpClientConfigurationBuilder
• LogBuilder
• LogRequestBuilder
• LogResponseBuilder
• ProxyConfigurationBuilder

HTTP

• HttpCallback
• HttpContext
• HttpRequest
• HttpResponse
• HttpStringResponse

Utilities

• ApiException
• ApiResponse
• ApiHelper
• CustomDateTimeConverter
• UnixDateTimeConverter