If you're designing a new one, I heartily recommend trying to go with https://aip.dev https://aip.dev guidelines; they are built on a lot of practical technique

If you're designing a new one, I heartily recommend trying to go with https://aip.dev https://aip.dev guidelines; they are built on a lot of practical techniques focused on making APIs future-proof (and also internally consistent).