![Range Queries
For Search endpoint: currency: [120 TO
10000]
For query endpoint: currency > 120 AND
currency < 10000](https://image.slidesharecdn.com/finalevolutionoftherestapi-190724174217/85/Evolution-of-the-REST-API-28-320.jpg)
Evolution of the REST API
- 1. Evolution of the Bullhorn REST API Craig Kapp, Amrutha Rajiv Bullhorn
- 2. Amrutha Rajiv Principal Software Architect Craig Kapp Principal Software Architect
- 3. Topics • Auth process • REST API Basics • Bullhorn One enhancements • Taurus - javascript REST sdk for the front end • Custom Cards
- 4. Auth Process
- 5. Auth Process Step 1 - get the authentication code URL: https://auth.bullhornstaffing.com/oauth/authorize Method:Post Payload: client_id={client_id} response_type=code state={recommended state value} Response: code username={username} password={password} action=Login
- 6. Auth Process Step 2 - get the access_token URL: https://auth.bullhornstaffing.com/oauth/token Method:Post Payload: client_id={client_id} client_secret={client_secret} Response: access_token grant_type={authorization_code} code={auth_code}
- 7. Auth Process Step 3 - get the rest token URL: https://rest.bullhornstaffing.com/rest- services/login &Method:Post Payload: version=* access_token={xxxxxxxx} Response: BhRestToken, restUrl
- 8. Easier Auth with Customizations • Skip step 1, get authCode directly from the customization – Custom Card – Custom Tab – Custom Action • Get access_token followed by BhRestToken
- 10. Important Links • Top Level REST URL – https://rest.bullhornstaffing.com/rest-services • Rest SDK (Java) - Software Development Kit – https://github.com/bullhorn/sdk-rest • Documentation – http://bullhorn.github.io/docs/ • Postman collection – https://documenter.getpostman.com/view/1437253/S1TZxadJ
- 11. Meta • What entities are available? – /meta • What properties do those entities have? – /meta/Candidate?field=*
- 12. Entity • GET - Read • PUT - Create • POST - Update • DELETE - Delete
- 13. Search and Query • /search/Candidate • /query/Tearsheet
- 19. New Entities • Billable Charge • Payable Charge • Invoice Statement • Invoice Statement Line Item
- 20. Effective Dated Entities • Location • Invoice Term • Billing Profile
- 21. Using EDEs • Add new root • Add new version • Update version • GET with effectiveOn date
- 22. Taurus - javascript REST sdk for the front end
- 23. Taurus Capabilities • Auto caching • Reactive API • Easy query construction syntax • Front-end Only https://github.com/bullhorn/taurus
- 24. Taurus examples
- 25. Retrieve Meta
- 27. Filter Query Syntax billingClientContact.name = ‘First Last’ jobOrder.clientContact.name = ‘First Last’
- 28. Range Queries For Search endpoint: currency: [120 TO 10000] For query endpoint: currency > 120 AND currency < 10000
- 29. • Deals with event streams • A sequence of events that happen over time • Whenever an event occurs, we react to it by doing something. Reactive Programming
- 30. RXJS & Observables • An observer subscribes to an Observable. • Observer reacts to whatever item or sequence of items the Observable emits. • Concurrent operations - non blocking Source: http://reactivex.io
- 31. bullhorn-types Typing in line with meta Example: export interface MessageTemplate { id?: number; dateAdded?: Date; isPublic?: boolean; messageText?: Strings; name?: Strings; owner?: CorporateUser; templateType?: Strings; }
- 32. Custom Cards
- 34. Custom Card DemoDemo: Invoices to Watch Card
- 35. Resources • Taurus: https://github.com/bullhorn/taurus • Bullhorn-types: https://github.com/bullhorn/bullhorn-types • Novo-elements: https://github.com/bullhorn/novo-elements • Custom Tab and authCode: http://bullhorn.github.io/REST-Backed- Custom-Components/
- 36. Recap • Auth simplified • SDKs make life easier • New Bullhorn One entities • EDEs respect effectiveOn • Taurus & bullhorn-types make your life easier
- 37. Questions?