DocID®DocID® Documentation
Back to DocID®
  • Overview

    • DocID® Documentation
  • Introduction

    • Introduction
    • How DocID® works
    • Core concepts
  • Getting Started

    • Getting Started
    • Drupal module
    • WordPress plugin
    • Custom website
    • Go-live checklist
  • Features

    • Features
    • Standard Login
    • Access and personalization
    • Analytics
    • Campaigns
  • Licenses

    • Licenses
  • OAuth 2.0

    • OAuth 2.0
    • Configure a client
    • Authorization code flow
    • Scopes and UserInfo
    • Security and environments
  • API

    • API
  • Help

    • Troubleshooting

API

API

Use the interactive DocID® API reference for supported business resources.

The DocID® business API is documented through an interactive Swagger interface.

Open the interactive API reference

The machine-readable OpenAPI document is available at:

1https://docid.pro/api/openapi.json

API versus OAuth

Use the OAuth 2.0 endpoints to authenticate a website visitor and retrieve approved identity information.

Use the business API for the management and application resources described in the OpenAPI document. Authentication requirements, request schemas, responses, and error codes are specified per operation in the interactive reference.

Safe API usage

  • Call privileged operations from trusted server-side code.
  • Use credentials intended for the current environment.
  • Validate every response and handle non-success status codes.
  • Do not log authorization headers or sensitive response data.
  • Use documented identifiers rather than inferring resource relationships.
PreviousSecurity and environmentsNextTroubleshooting

On this page

  1. API versus OAuth
  2. Safe API usage