Ramp Reference Architecture Skill

Ramp Reference Architecture

Overview

Implementation patterns for Ramp reference architecture using the Developer API with OAuth2 authentication.

Prerequisites

Completed ramp-install-auth setup

Instructions

Step 1: API Call Pattern

import os, requests

# Obtain token
token_resp = requests.post(f"{os.environ['RAMP_BASE_URL'].replace('/v1','')}/v1/token", data={
    "grant_type": "client_credentials",
    "client_id": os.environ["RAMP_CLIENT_ID"],
    "client_secret": os.environ["RAMP_CLIENT_SECRET"],
})
access_token = token_resp.json()["access_token"]
headers = {"Authorization": f"Bearer {access_token}"}

cards = requests.get(f"{os.environ['RAMP_BASE_URL']}/cards", headers=headers)
print(f"Cards: {len(cards.json()['data'])}")

Output

Ramp API integration for reference architecture

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | 401 Unauthorized | Expired token | Re-authenticate | | 429 Rate Limited | Too many requests | Implement backoff | | 403 Forbidden | Insufficient permissions | Check API app permissions |

Resources

Next Steps

See related Ramp skills for more workflows.

Agent Skills: Ramp Reference Architecture

Install this agent skill to your local

Skill Files