Security Cloud Courses About
imgs/hero.webp

Amazon API Gateway Serverless Developer Portal

AWS Labs has a lot of open source code up on GitHub. This project, “Amazon API Gateway Serverless Developer Portal” builds a slick web interface for your Amazon API Gateway APIs.

Think of it like automatic documentation. It’s a great way to help developers get up to speed with your APIs.

I call out a few more details in the Twitter thread below…

Tweet 1/9 ๐Ÿ‘‡ Next tweet

this thread is going to look at "Amazon API Gateway Serverless Developer Portal" by @awscloud Labs on GitHub at https://github.com/awslabs/aws-api-gateway-developer-portal

this project delivers a web portal for developer engagement with your APIs

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 2/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

this thread is unrolled at https://t.co/4d3MidmVDs

the last thread is at https://markn.ca/2021/amazon-s3-glacier-refreezer/

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 3/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

this is what this project builds out for you ๐Ÿ‘‡

it’s like fancy automated documentation + self-serve provisioning

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 4/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

the project has spent a lot of time on deployment. you can roll it out via SAM, SAR, or script

like good docs, that’s very much appreciated

more on SAM at https://aws.amazon.com/serverless/sam/

more on SAR at https://aws.amazon.com/serverless/serverlessrepo/

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 5/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

this project addresses a big gap for most teams. they might build out a solid API but how do you get the word out to developers?

having clear documentation & a way to get an API key/token yourself is really important for the developer experience (#dx)

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 6/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

this project doesn't go beyond the basic endpoint/parameters documentation. YOU need to add in the "here's how to get the most out of this API" and other, more in-depth documentation

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 7/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

there's a fair bit of customization built into the project as well. you can adjust the branding and add your own content, like ๐Ÿ‘†

more on customization at https://github.com/awslabs/aws-api-gateway-developer-portal/wiki/Customization

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 8/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

under the covers, here's what the project builds ๐Ÿ‘‡

it’s a pretty lightweight, #serverless build. that will keep operations light and the costs low

๐Ÿงตโ˜๏ธ #cloud #devops

Tweet 9/9 ๐Ÿ‘‡ Next tweet ๐Ÿ‘† Start

if you're building out APIs using @awscloud API Gateway (even if they are internal-only), this project should help you document those APIs & provision access

check it out at https://github.com/awslabs/aws-api-gateway-developer-portal

/๐Ÿงตโ˜๏ธ #cloud #devops