Introduction to the Okapi API
The Okapi API is currently in alpha.
For most folks who want to integrate with Okapi, you need to do two things:
To make more sense of the records-related endpoints, it helps to understand Okapi’s core data model. You can also hit objects-related endpoints if you’d like to customize the types of data you track in your Okapi instance.
To get an API key:
You can now use this API key to interact with Okapi. For instance, try this endpoint to list the objects in your instance:
Okapi is centered around objects and records. Almost everything is either an instance of one of those two, or mostly just manipulates these.
Objects are customizable data types. Objects have a name and a set of field definitions, each of which also has a name and a type. Objects are how you decide what you want to track. “Company” is a common object.
Records are instances or occurrences of objects. Every record is associated with exactly one object, and has data associated with the field definitions on that object. “Microsoft” or “Apple” are possible records of the “Company” object.
A typical Okapi instance might have tens to possibly hundreds of objects, but very rarely more. A typical Okapi instance may have millions of records.
Introduction to the Okapi API
The Okapi API is currently in alpha.
For most folks who want to integrate with Okapi, you need to do two things:
To make more sense of the records-related endpoints, it helps to understand Okapi’s core data model. You can also hit objects-related endpoints if you’d like to customize the types of data you track in your Okapi instance.
To get an API key:
You can now use this API key to interact with Okapi. For instance, try this endpoint to list the objects in your instance:
Okapi is centered around objects and records. Almost everything is either an instance of one of those two, or mostly just manipulates these.
Objects are customizable data types. Objects have a name and a set of field definitions, each of which also has a name and a type. Objects are how you decide what you want to track. “Company” is a common object.
Records are instances or occurrences of objects. Every record is associated with exactly one object, and has data associated with the field definitions on that object. “Microsoft” or “Apple” are possible records of the “Company” object.
A typical Okapi instance might have tens to possibly hundreds of objects, but very rarely more. A typical Okapi instance may have millions of records.