https://pinboard.in/u:earth2marsh/public/ recent bookmarks from earth2marsh 2024-12-15T06:34:19+00:00 https://surfingcomplexity.blog/2024/12/14/quick-takes-on-the-recent-openai-public-incident-write-up/ earth2marshOpenAI recently published a public writeup for an incident they had on December 11, and there are lots of good details in here! Here are some of my off-the-cuff observations: Saturation With thousands of nodes performing these operations simultaneously, the Kubernetes API servers became overwhelmed, taking down the Kubernetes control plane in most of our large clusters.]]> openai outage kubernetes complex systems failures api https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:4839039ca20c/ 2024-05-26T07:27:36+00:00 https://mintlify.com/ earth2marsh api docs documentation service https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:79ab787a0d50/ 2020-09-03T01:13:05+00:00 https://cloud.withgoogle.com/next/sf/sessions?session=API102#business-application-platform earth2marsh GoogleCloudNext DigitalTransformation API devex https://twitter.com/ https://pinboard.in/u:earth2marsh/b:63d6ead27029/ 2019-09-10T23:22:27+00:00 https://stoplight.io/studio/ earth2marsh api design tools https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:e315dc40fdaa/ 2018-11-19T19:44:21+00:00 https://blog.twitter.com/official/en_us/topics/product/2018/investing-in-the-best-twitter-experience-for-you.html earth2marsh twitter api strategy timeline https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:5ed1c29137c1/ 2018-09-20T21:15:56+00:00 https://twitter.com/i/web/status/1042879221784170497 earth2marsh API OASv3 https://twitter.com/ https://pinboard.in/u:earth2marsh/b:a297b29915a0/ 2018-03-06T15:08:39+00:00 https://caseysoftware.com/blog/three-styles-api-documentation earth2marsh Documentation API https://twitter.com/ https://pinboard.in/u:earth2marsh/b:f05e7087f01c/ 2017-12-03T23:23:59+00:00 https://thenextweb.com/contributors/2017/12/03/heres-choose-sdk-api/ earth2marsh apis sdks api skd choices comparison tradeoff https://pinboard.in/u:earth2marsh/b:700c6dbfeeaa/ 2017-03-03T02:44:05+00:00 http://antirez.com/news/107 earth2marshprogramming design api APIs craft https://pinboard.in/u:earth2marsh/b:8428f718ff09/ 2017-02-23T21:36:22+00:00 http://www.perspectiveapi.com/ earth2marsh google apis api abuse content sentiment moderation toxicity https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:31822d4e6b23/ 2016-10-04T18:31:36+00:00 https://openapis.org/news/blogs/2016/10/tdc-structural-improvements-explaining-30-spec-part-2 earth2marsh API https://twitter.com/ https://pinboard.in/u:earth2marsh/b:b08825ba0514/ 2016-09-13T06:27:19+00:00 http://apievangelist.com/2016/09/12/api-stylebook-a-collections-of-resources-for-api-designers/ earth2marsh IFTTT Feedly apis design api guidelines style styles https://pinboard.in/u:earth2marsh/b:83810ca3b955/ 2016-08-26T23:25:51+00:00 https://github.com/paypal/api-standards/blob/master/api-style-guide.md earth2marsh paypal api standards style guide https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:b934ddb8689c/ 2016-05-27T23:54:42+00:00 http://www.slideshare.net/jmusser/why-api-ops-is-the-next-wave-of-devops-62440606/49 earth2marsh api apis lifecycle musser https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:edd37fdfaf5c/ 2016-05-27T18:38:57+00:00 http://www.slideshare.net/launchany/designing-apis-and-microservices-using-domaindriven-design earth2marshapis design api microservices domain driven development https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:70872324ee06/ 2016-05-18T16:24:16+00:00 https://en.wikipedia.org/wiki/Hungarian_notation earth2marsh Encoding the type of a function into the name (so-called Hungarian notation) is brain damaged—the compiler knows the types anyway and can check those, and it only confuses the programmer. Re: https://www.hl7.org/fhir/patient.html]]> naming variables api apis design bestpractices https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:0e71c5450109/ 2016-05-05T19:35:33+00:00 https://ardielle.github.io/ earth2marsh apis descriptions api description format https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:0109913829b2/ 2016-05-05T19:34:55+00:00 https://github.com/ardielle/ardielle-common earth2marsh apis api descriptions description format https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:fe7aefc82dd9/ 2016-04-20T01:27:54+00:00 http://apieconomist.com/blog//jennifer-rondeau-on-the-mix-of-grammar-and-tech-in-api-documentation earth2marsh api apis documentation people language art https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a02b2392db88/ 2016-03-23T16:51:06+00:00 https://groups.google.com/forum/#!msg/siren-hypermedia/lmPrsrDBhVE/OF4orjkGAwAJ earth2marsh kevin_swiber apis api design models modeling data https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:ef8e80cfbb22/ 2016-03-23T15:10:00+00:00 https://groups.google.com/forum/#!topic/api-craft/n2Efmju5nLM earth2marsh PUT verbs api apis design objects resources https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:7f527112f74a/ 2016-03-14T23:03:18+00:00 http://nordicapis.com/core-principles-api-management/ earth2marsh api apis management https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:1887ec1833e6/ 2016-03-01T16:44:52+00:00 https://medium.com/@matryer/introducing-silk-markdown-driven-api-tests-1f8cfb0ef99a earth2marshAPI APIs documentation tests markdown https://pinboard.in/u:earth2marsh/b:76e78d27c20c/ 2016-02-29T19:07:45+00:00 https://www.owasp.org/index.php/Top_10_2010-A4-Insecure_Direct_Object_References earth2marsh api design objects threats security resources owasp https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:dbcd716122b6/ 2015-08-11T15:39:40+00:00 http://mmikowski.github.io/the_lie/ earth2marsh rest apis API design json https://pinboard.in/u:earth2marsh/b:725f8eaf2268/ 2015-05-26T08:31:27+00:00 https://github.com/JimRobs/syno earth2marsh IFTTT github synology apis api nodejs node https://pinboard.in/u:earth2marsh/b:fe426b5eeb03/ 2015-03-26T18:24:37+00:00 http://www.infoq.com/presentations/API-Business-Models earth2marshmodels business management api musser john_musser https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:8d769246f21f/ 2014-12-17T01:37:53+00:00 http://swapi.co/ earth2marsh starwars api apis https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:8e0744958148/ 2014-09-23T20:56:56+00:00 https://github.com/apigee-127/swagger-tools/blob/master/docs/QuickStart.md earth2marsh API OSS Swagger https://twitter.com/ https://pinboard.in/u:earth2marsh/b:e7df9b54b64a/ 2014-07-23T22:15:01+00:00 http://blog.mention.com/what-we-can-learn-from-the-yo-api/ earth2marsh yo api apis design simplicity https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:421b8b7a2ade/ 2014-06-25T15:10:20+00:00 http://www.deployd.com/ earth2marsh tools development app api mobile https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:54cf67e4f7f7/ 2014-05-05T22:00:06+00:00 http://stackoverflow.com/questions/19623339/is-a-list-array-valid-json earth2marsh api apis design arrays json patterns stackoverflow https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a2c5ab882d0f/ 2014-03-08T16:12:39+00:00 https://github.com/scripting/fargoPublisher/blob/master/README.md earth2marshstatic HTML publishing api apis Dave_Winer https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a13381d09155/ 2014-02-17T21:07:28+00:00 https://restberry.com/#/#top earth2marshapi documentation modeling apis mocking https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a82333843fa1/ 2014-02-17T18:32:00+00:00 https://www.leftronic.com/blog/five-hair-pulling-apis/ earth2marshapi apis design mistakes analytics sins https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:95bf231766e2/ 2014-02-05T16:01:17+00:00 http://brandur.org/sdk earth2marsh sdk APIs development sdks api https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:6cbf427f7bf6/ 2014-01-29T23:08:15+00:00 https://groups.google.com/forum/m/#!topic/foursquare-api/X60gF5Zi0k4 earth2marsh APIs api design patterns versions versioning foursquare query https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:ead28e4ba3b8/ 2013-12-10T04:23:08+00:00 http://byterot.blogspot.com/2013/10/api-layer-and-its-responsibilities-rest-viewpoint-webapi-csds-aspnetwebapi.html?m=1 earth2marsh APIs API layer soa soap rest https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:ed637842ec8e/ 2013-12-05T18:22:12+00:00 http://www.infoq.com/news/2013/12/api-versioning earth2marsh versioning api design https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:3f284580601e/ 2013-12-03T17:45:06+00:00 https://npmjs.org/package/fakeson earth2marsh api mocking mocks apis rest https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:4f845c8b8883/ 2013-12-03T17:42:57+00:00 http://www.mocky.io/ earth2marsh mock http api mocking https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:b97f97224d90/ 2013-12-02T19:59:22+00:00 http://whatismyipaddress.com/api earth2marsh ip addresses api discovery https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:fb1422e29023/ 2013-11-21T02:00:00+00:00 http://doc.qt.digia.com/qq/qq13-apis.html earth2marsh api apis design https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:9284115f93d9/ 2013-11-21T01:33:43+00:00 https://github.com/peej/tonic earth2marsh api rest framework php design https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a06db091dd17/ 2013-11-16T00:42:31+00:00 http://apimetrics.io/features/ earth2marsh api apis monitoring https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:c53ffedc5824/ 2013-11-09T00:46:15+00:00 https://www.owasp.org/index.php/REST_Security_Cheat_Sheet earth2marsh cheatsheet rest security api apis https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:6a07ef4ab27f/ 2013-11-05T00:37:15+00:00 http://developer.github.com/v3/media/#api-v3-media-type-and-the-future earth2marsh api design github apis versioning mediatypes https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:f266578ed6bb/ 2013-11-03T18:25:18+00:00 https://pinboard.in/u:arnaud/t:api/ earth2marsh pinboard api people apis https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:ff219832003a/ 2013-10-25T13:06:23+00:00 http://tech.blog.box.com/2012/12/going-beyond-oauth2-byod-in-the-enterprise/ earth2marsh box api apis design authentication devices oauth https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:b5cfe772cdff/ 2013-10-25T12:42:44+00:00 http://lists.w3.org/Archives/Public/w3c-dist-auth/1999JanMar/0128.html earth2marsh multiple errors webdav api apis design https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:9211232b0260/ 2013-10-25T12:35:39+00:00 http://tech.blog.box.com/2013/04/get-developer-hugs-with-rich-error-handling-in-your-api/ earth2marsh api apis design http errors box bestpractices https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:8a0c915a520a/ 2013-10-24T19:11:24+00:00 http://www.mnot.net/blog/2013/05/15/http_problem earth2marsh json http rest api apis design mnot errors https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:9bdfa0165f39/ 2013-10-10T16:45:16+00:00 http://humanapi.co/ earth2marsh healthcare api data portal design example https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:2b0bdda78ee8/ 2013-09-23T14:39:53+00:00 http://flippinawesome.org/2013/09/23/easy-api-scaffolding-with-simple-api-and-node-js/ earth2marshnode nodejs mocking api design apis https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a9ab51d990f0/ 2013-09-12T16:15:13+00:00 http://codebetter.com/howarddierking/2013/09/12/versioning-restful-services-v2/ earth2marsh versioning rest api apis design https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:d72b15660ffb/ 2013-09-10T23:20:50+00:00 https://news.ycombinator.com/item?id=6361662 earth2marsh?), but if someone ends up polling your API frequently, having those two features can reduce a lot of unnecessary load for both you and the poller. And, of course, make sure you have an index on the created and/or updated dimensions. That said, webhooks are terrific. Few things to consider when implementing them: - Think carefully about the payload you send to the webhook. It's usually a good idea to send some related objects/data because many times when someone gets a webhook payload, that'll trigger calls to your API to get related information you could've reasonably sent them in the initial payload. - You'll likely want to some way to keep track of errors so if an endpoint starts returning 404s or 500s you have a way to programmatically discard it after X failed attempts. - In your docs, give sample, "real world" payloads developers can test against. It saves times over creating a RequestBin, pushing there, copying, cURLing, etc. (Remember, you can't set up a webhook to localhost.) - A nice to have is some sort of retry capability with an exponential back-off. Servers go offline and if they get pushed webhook data then, those messages are lost. You could say, "tough, it's the consumer's responsibility," but if having all the data is important, most people will resort to polling. (Somewhat related, you'd be surprised how often the APIs of some larger SaaS companies are "offline" -- e.g. returning 503 --, so these things do happen.)"]]> webhooks api apis design https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:9658b3061911/ 2013-08-07T04:38:35+00:00 http://docs.oocharts.com/ earth2marsh analytics api Google wrapper dashboard visualizations service https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:9dd20dbc8a7b/ 2013-07-23T20:37:59+00:00 https://mathieu.fenniak.net/the-api-checklist/ earth2marsh checklist restful api design apis rest https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:bc71f06b338e/ 2013-07-23T02:01:16+00:00 https://github.com/trentm/restdown earth2marsh markdown rest api apis documentation descriptions https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:b06981f23075/ 2013-07-23T02:00:01+00:00 http://friends.diy.org/ earth2marsh rest api apis documentation generated https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:e908cf95a218/ 2013-07-09T03:03:52+00:00 https://tools.ietf.org/html/draft-nottingham-http-problem-03 earth2marshurl APIs design api urls errors https://pinboard.in/u:earth2marsh/b:c4540de04dc1/ 2013-05-24T21:36:35+00:00 http://www.garethshapiro.com/item/simple-objective-c-api-service earth2marsh mocking apis api ios objectivec https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:319f3523a7df/ 2013-05-21T16:12:54+00:00 http://www4.in.tum.de/~blanchet/api-design.pdf earth2marsh pdf api apis design development https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:3baefb83b541/ 2013-05-18T03:33:44+00:00 http://apiaxle.com/ earth2marsh api proxy https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:12e01cdf59ee/ 2013-05-15T14:54:13+00:00 http://dev.w3.org/2009/dap/ReSpec.js/documentation.html#webidl-support earth2marshapi descriptions ietf tools https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:5614c254f512/ 2013-04-25T16:16:07+00:00 https://mathieu.fenniak.net/stop-designing-fragile-web-apis/ earth2marsh ifttt via:pocket api apis design fragility intent https://pinboard.in/u:earth2marsh/b:ce0800bcd234/ 2013-03-22T23:37:02+00:00 https://api.pinboard.in/v1/posts/all earth2marsh /backupdir/pinboard-myuser.json.gz]]> pinboard backup api https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:81c4207608ad/ 2013-03-01T17:12:26+00:00 https://www.balancedpayments.com/ earth2marsh iftttGR apis api payment processing https://pinboard.in/u:earth2marsh/b:c77dc9b07d3a/ 2013-02-20T17:38:53+00:00 https://github.com/linkedin/rest.li/wiki/Rest.li-.restspec.json-Format earth2marsh linkedin descriptions format apis api schema schemas opensource https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:df5e7c683284/ 2013-02-04T07:18:25+00:00 https://developers.facebook.com/roadmap/change-policy/ earth2marsh facebook api apis breaking changes deprecation policy community management https://pinboard.in/ https://pinboard.in/u:earth2marsh/b:a3a237cd9d3f/