pks + api   69

Bringing law and order to APIs with OpenAPI Specifications
If you’re building cars, a specification tells you how a car works. It includes the most important details and perhaps a list of requirements that the end product should fulfill. Once the car gets…
swagger  ci  Documentation  API 
15 days ago by pks
RESTful API Designing Guidelines — The Best Practices
Facebook, Google, GitHub, Netflix, and a few other tech giants have given developers and products a chance to consume their data through APIs and became a platform for them. Even if you are not…
API  rest 
21 days ago by pks
API Evolution for REST/HTTP APIs | APIs You Won't Hate - A community that cares about API design and development.
API Evolution is making a comeback these days, and REST advocates have been begging folks to use it for years. Let's learn how.
API 
6 weeks ago by pks
API Design-First vs Code First | APIs You Won't Hate - A community that cares about API design and development.
With API descriptions rising in popularity, the main question I hear folks asking about is "API Design-first" or "code-first". This is a bit of a misleading question because these are not two unique things, there are a few variants.
swagger  Documentation  API 
6 weeks ago by pks
API Design Guide  |  Cloud APIs  |  Google Cloud
This is a general design guide for networked APIs. It has been used inside Google since 2014 and is the guide that Google follows when designing Cloud APIs and other Google APIs. This design guide is shared here to inform outside developers and to make it easier for us all to work together.
API 
september 2019 by pks
API Mindset at eBay
APIs allow organizations to give their partners access to data and capabilities, at scale. Extensible and adaptable API ecosystems make it easier for developers to innovate. Building such an ecosystem is a progressive journey with many technical challenges.
API 
july 2019 by pks
8 Fun, Random, and Useless APIs to Tinker With Today | Nordic APIs |
Eight of the world’s fun, random, and useless APIs that we think you’ll love tinkering with. From generating placeholder text to sourcing information about your favorite fantasy worlds, these APIs are some of the most light-hearted demonstrations of the power of APIs.
API 
july 2019 by pks
Fuck Off As A Service (FOAAS)
FOAAS (Fuck Off As A Service) provides a modern, RESTful, scalable solution to the common problem of telling people to fuck off.
API  rest  katherine  humor 
july 2019 by pks
API Governance for IT Culture Change
Here is a copy of the presentation that I gave at API World 2017. I've had the fortune (or misfortune, as the case may be) to work on API platform governance...
API 
june 2019 by pks
Consistency AND Cohesion
Many find they have not one, not two, but dozens of APIs within their organization. RESTful APIs are descriptive, not prescriptive. That is, there is so much...
API 
june 2019 by pks
API Improvement Proposals
AIP stands for API Improvement Proposal, which is a design document providing high-level, concise documentation for API development. The goal is for these documents to serve as the source of truth for API-related documentation at Google and the way API teams discuss and come to consensus on API guidance.
API 
may 2019 by pks
APIMatic - Developer Experience Platform for APIs
A Developer Experience Platform for APIs. Services include: Developer Portal Generation, SDK Generation, Documentation Generation, Code Sample Generation, API Specification Conversion, CI/CD Integrations, Package Publishing
API  Documentation 
may 2019 by pks
Useful API Errors for REST, GraphQL and gRPC – APIs You Won't Hate
Dealing with the Happy Path™ in an API is pretty easy: When a client asks for a resource, show them the resource. When they trigger a procedure, let them know if it was triggered OK, and maybe if it…
api 
april 2019 by pks
REST vs. GraphQL: A Critical Review
A critical review of the popular API paradigms.
graphql  rest  API 
april 2019 by pks
Designing APIs for Microservices | Stoplight API Corner
To recap, designing microservice APIs is as important as designing other APIs, especially if you want to gain the benefits of the microservice architecture. The important considerations are:

Don’t underestimate the role of API design
Design non-chatty interfaces for improved performance
Achieve loose coupling by building a versioned, evolvable design
Model your domain and design your API after that model, not a specific implementation
API  swagger 
march 2019 by pks
Stop Calling Your APIs Microservices | Stoplight API Corner
Microservices and APIs are not the same and, while we’re at it, neither are microservices and containers. However, the two concepts work together in two different ways: First, microservices can be a means to deploy the backend for an internal, partner, or public API. Second, microservices typically rely on APIs as a language-independent means to communicate with each other in an internal network. Development teams can use similar design approaches and tools for creating both outward-facing and microservice APIs.
microservices  API 
march 2019 by pks
To Create An Evolvable API, Stop Thinking About URLs
This post shows some code examples of how to store the state in the network and the fundamentals of an evolvable API. It also talks about how to decouple client and server.
API 
march 2019 by pks
public-apis/README.md at master · toddmotto/public-apis · GitHub
A collective list of free APIs for use in software and web development.
API 
february 2019 by pks
Supermodel
The JSON Schema Registry
Collaborative data modeling that works in the real world.
API 
january 2019 by pks
The 5 laws of API dates and times | API UX
Let’s say you’re building your first API. Be it public, private, or some hybrid thereof, don’t be surprised if your first defect is date/time-related. Do not underestimate how much trouble you can get into when it comes to handling date and times.
API 
january 2019 by pks
The Three Principles of Excellent API Design | Nordic APIs |
We feature Arnaud Laruet on building purposeful, usable, and properly constrained APIs: 3 qualities he explores in his book The Design of Everyday APIs.
API 
december 2018 by pks
A Gardener's Approach to Growing an API Culture
My work on pragmatic software governance has evolved. It started with a focus scaling good API design across a modern enterprise company. Increasingly, I'm i...
rest  graphql  API  Architecture  hateoas 
november 2018 by pks
Lean API Development Method - APIOps Cycles
Great APIs are made by skilled humans working together using a great business-oriented method - APIOps Cycles
API 
november 2018 by pks
API Versioning Has No “Right Way” – APIs You Won't Hate
API versioning is a really difficult topic, and sometimes seen as a merely religious debate. It’s done differently at different companies, and different teams within different companies often vary…
API 
august 2018 by pks
Visualising complex APIs using API Map – Hacker Noon
That is one of the reasons why we like to represent most complex ideas of software through pictures and diagrams. Class and sequence diagrams are most commonly understood but there are a large number…
API  swagger 
august 2018 by pks
My API Lifecycle Checklist And Scorecard
To help guide my workflow, I’ve crafted this API lifecycle definition to help direct my efforts in an ongoing lifecycle approach.
API 
august 2018 by pks
A guide to RESTful API design: 35 must-reads | TechBeacon
Learn RESTful API design from this guide to the best API design resources on the web.
rest  API 
august 2018 by pks
Designing Microservice Architectures the Right Way: Michael Bryzek's Lessons Learned at QCon NY
At QCon New York 2018, Michael Bryzek discussed how to design microservice architectures “the right way”. Key takeaways included: engineers should design schema first for all APIs and events, as this allows the automated code generation of boilerplate code; and investment should be made in automation, such as deployment and dependency management.
microservices  API 
august 2018 by pks
APIs You Won't Hate
Everyone And Their Dog Wants An API, So You Should Probably Learn How To Build Them.
rest  grpc  graphql  API 
may 2018 by pks
API Change Strategy | Nordic APIs |
Asbjorn describes a new approach to API versioning, outlining five aspects of smart API change management. Learn to adopt an API change strategy that avoids breaking change yet maintaining efficient development techniques.
API  blog  hateoas 
march 2018 by pks
How a RESTful API represents resources - O'Reilly Media
Formats, linking, and versioning are important in well-formed RESTful APIs.
rest  API 
january 2018 by pks
http://www.icndb.com/api/
RESTful service to deliver JSON response, useful for testing
API 
december 2017 by pks
The Benefits of Using JSON API | Nordic APIs |
JSON API, defined at JSONAPI.org, is a practical spec for building web APIs. Its caching features can streamline API requests and increase data consistency.
API  json 
december 2017 by pks
Using A Schema-First Design As Your Single Source of Truth | Nordic APIs |
In modern software development, reaching platform-wide consistency relies on having a single source of truth. Learn how schema-first achieves this.
API 
december 2017 by pks
What Qualities Make a Great API Product Owner? | Nordic APIs |
From programming expertise, team collaboration, to external and internal advocacy, we identity the traits that make up a truly great web API product owner.
API 
october 2017 by pks
How to Optimize the API Response Package | Nordic APIs |
We describe pagination, filtering, ranging, and other design techniques that can be used to optimize a web API response.
API 
october 2017 by pks
Best Practices for Designing a Pragmatic RESTful API | Vinay Sahni
An API is a user interface for a developer. Learn the best practices to make an API that is easy to adopt and pleasant to use.
rest  API 
july 2017 by pks
RESTful API Design Tips from Experience – studioarmix – Medium
I am reminded of a lovely quote that I found through another Medium post by Ken Rogers, of which was originally written by Hemingway: As I write this, I chuckle to myself in seeing a great parallel…
rest  API  microservices 
june 2017 by pks
Ideal API versioning
great api versioning strategy
rest  API 
january 2017 by pks
Ultimate Guide to 25 API Documentation Solutions
A comprehensive list of documentation generators for web APIs. Compare over 30 API doc solutions side by side. Swagger UI, Apiary, Readme, Aglio, ReDoc ...
API  Documentation 
december 2016 by pks
10 Mistakes to Avoid When Building Your API - HelloSign Blog
Building an API? You'll most definitely want to read this.
API  rest  Documentation 
october 2016 by pks
WhiteHouse/api-standards
Contribute to api-standards development by creating an account on GitHub.
rest  API 
july 2016 by pks
api-standards/api-style-guide.md at master · paypal/api-standards
Contribute to api-standards development by creating an account on GitHub.
rest  API  Documentation 
april 2016 by pks
Boost Your REST API with HTTP Caching
You can significantly boost the performance of your RESTful services by setting a simple HTTP response header. Learn how to do it.
rest  API  Varnish 
april 2016 by pks
The Core Principles of API Management | Nordic APIs |
API management is a term that has been used in the API economy for several years and has existed without acquiring an exact, universal definition. While most protagonists in the API community agree on the core themes of **API management** and why the subject is important, the specifics are frequently defined by the capabilities of commercial “API management” solutions. The term has become so synonymous with these solutions that more than one have it engraved in their brand.
API  rest 
march 2016 by pks
Home · Netflix/Hystrix Wiki
Hystrix is a latency and fault tolerance library designed to isolate points of access to remote systems, services and 3rd party libraries, stop cascading failure and enable resilience in complex distributed systems where failure is inevitable.
API  netflix 
march 2016 by pks

Copy this bookmark:



description:


tags: