Skip to content
Snippets Groups Projects
Commit 32134005 authored by Rebecca Wheeler's avatar Rebecca Wheeler
Browse files

Update 4 files

- /docs/tutorials/API_Related/SupOrg_and_CostCenter/CostCenter.md
- /images/jsonResponse.png
- /images/SwaggerSettings1.png
- /images/SwaggerSettings2.png
parent a11b9344
No related branches found
No related tags found
1 merge request!79Update 12 files
......@@ -8,9 +8,33 @@ Cost Centers represent accounting groups and subgroups used to track accounting
# Create a Swagger File and host it
Here is a document previously written about [creation of swagger files](~/docs/tutorials/API_Related/PersonAPI/PersonAPIwRESTv2.md#creating-your-own-swagger-files) for reference.
- Here is a document previously written about [creation of swagger files](~/docs/tutorials/API_Related/PersonAPI/PersonAPIwRESTv2.md#creating-your-own-swagger-files) for reference.
- If you need a place to publically host your swagger file, you can use the [Respository](https://git.doit.wisc.edu/interop/iics/iics-swagger-file-public-repository) that the Integration Team has set up for this purpose.
1) The first step to create this swagger file will be to use [Postman](https://www.postman.com/product/api-client/) or a similar API client with your Developer Portal's registered App's credentials to save a response for the Finance API's [costCenters endpoint](https://developer.wisc.edu/docs/asp-api-finance/1/routes/costCenters/get).
![JsonResponse](images/jsonResponse.png)
2) Next, head to Informatica. You'll want to be in the Administrator section, then click "Swagger Files" in the left column.
3) Click "New" in the upper right and fill in the fields as seen in the two screenshots below.
- Create a name.
- Select a runtime environment (the same Secure Agent you typically work from).
- URL: https://api.wisc.edu
- Verb: GET
- Authentication Type: None
- API Base Path: /finance
- API Path: /costCenters
- Accept: application/json
- Query Params: **{"page[number]": 0,"page[size]: 100}**
- Operation Id: Get_Costcenters (this can be anything you like, it's for your reference only)
- JSON Response File: This is the file you created in Step 1 above.
![Swagger1](images/SwaggerSettings1.png)
![Swagger2](images/SwaggerSettings2.png)
4) Click "Save" in the upper right, then find the Swagger File you just created and download it.
5) You will need to host this file publicly. If you don't have your own repository to do this, you can use the EI Integration Team's [Swagger Repository](https://git.doit.wisc.edu/interop/iics/iics-swagger-file-public-repository). Please be mindful of our [organizational strategy](https://git.doit.wisc.edu/interop/iics/iics-swagger-file-public-repository/-/blob/main/file-organization-guidelines.md).
# Rest V2 connection to the API
......
images/SwaggerSettings1.png

89.6 KiB

images/SwaggerSettings2.png

32.6 KiB

images/jsonResponse.png

117 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment