# Best Practices

Petro.ai's API is constantly evolving with new collections and endpoints for users to pull from. With that in mind, we try to keep the information as up-to-date as possible.

# Postman

Debugging API requests in scripts is tedious and error prone. The Postman application reduces this friction by allowing constructing of adhoc requests. Download Postman here

# Known issues

  • Data type entwining (DB Normalization): Data type endpoints do not account for normalized data across multiple data types. This is especially relevant to Wells and Well Identifiers.
  • Be aware that some data types are missing some HTTP methods—don’t assume availability and use the API documentation.

# Warnings

WARNING

Missing fields in PUTs will get default values and default values are not shown in the API Docs

WARNING

A new document will be created if the ID/PWI provided cannot be found.