PaxHelm API. आपका डेटा, आपकी पहुँच में।
आपके वर्कस्पेस के काम, प्रोजेक्ट, नोट्स, रिमाइंडर, फ़ॉलो-अप और लोग HTTPS और JSON पर, उन्हीं अनुमतियों के साथ जो ऐप में आपकी हैं। API से कुछ भी हटाया नहीं जाता।
प्रमाणीकरण
सेटिंग्स › सुरक्षा › API में निजी टोकन बनाएँ और हर अनुरोध के साथ भेजें: Authorization: Bearer pxa_…. टोकन एक बार दिखता है, उसकी समय-सीमा हो सकती है और उसे कभी भी रद्द किया जा सकता है। दायरे: pdash.read, pdash.write.
curl -H "Authorization: Bearer pxa_…" https://paxhelm.com/api/v1/tasks?status=openसूचियाँ, वर्शन और सीमाएँ
सूचियाँ पन्नों में आती हैं, सबसे नई पहले। हर बदलाव पढ़ा हुआ expectedVersion साथ भेजता है और अगर बीच में रिकॉर्ड बदल गया हो तो 409 लौटाता है। हर टोकन पर प्रति मिनट 120 अनुरोध तक; बॉडी 64 KB तक।
एंडपॉइंट
एंडपॉइंट के विवरण अंग्रेज़ी में हैं, OpenAPI दस्तावेज़ की तरह।
| मेथड | पाथ | दायरा | क्या करता है |
|---|---|---|---|
GET | /api/v1/tasks | pdash.read | List tasks, newest first |
POST | /api/v1/tasks | pdash.write | Create a task |
GET | /api/v1/tasks/{id} | pdash.read | Get one task |
PATCH | /api/v1/tasks/{id} | pdash.write | Change a task (send only the fields to change, with expectedVersion) |
POST | /api/v1/tasks/{id}/complete | pdash.write | Complete a task |
POST | /api/v1/tasks/{id}/reopen | pdash.write | Reopen a task |
GET | /api/v1/projects | pdash.read | List projects, newest first |
POST | /api/v1/projects | pdash.write | Create a project |
GET | /api/v1/projects/{id} | pdash.read | Get one project |
PATCH | /api/v1/projects/{id} | pdash.write | Change a project (send only the fields to change, with expectedVersion) |
GET | /api/v1/notes | pdash.read | List notes, newest first |
POST | /api/v1/notes | pdash.write | Create a note |
GET | /api/v1/notes/{id} | pdash.read | Get one note |
PATCH | /api/v1/notes/{id} | pdash.write | Change a note (send only the fields to change, with expectedVersion) |
GET | /api/v1/reminders | pdash.read | List reminders, newest first |
POST | /api/v1/reminders | pdash.write | Create a reminder |
GET | /api/v1/reminders/{id} | pdash.read | Get one reminder |
PATCH | /api/v1/reminders/{id} | pdash.write | Change a reminder (send only the fields to change, with expectedVersion) |
POST | /api/v1/reminders/{id}/complete | pdash.write | Complete a reminder |
POST | /api/v1/reminders/{id}/snooze | pdash.write | Snooze a reminder |
GET | /api/v1/follow-ups | pdash.read | List follow-ups, newest first |
POST | /api/v1/follow-ups | pdash.write | Create a follow-up |
GET | /api/v1/follow-ups/{id} | pdash.read | Get one follow-up |
PATCH | /api/v1/follow-ups/{id} | pdash.write | Change a follow-up (send only the fields to change, with expectedVersion) |
POST | /api/v1/follow-ups/{id}/close | pdash.write | Close a follow-up |
GET | /api/v1/people | pdash.read | List people, newest first |
POST | /api/v1/people | pdash.write | Create a person |
GET | /api/v1/people/{id} | pdash.read | Get one person |
PATCH | /api/v1/people/{id} | pdash.write | Change a person (send only the fields to change, with expectedVersion) |
वेबहुक
कुछ बदलने पर PaxHelm आपके HTTPS पते को सूचना भेजता है; हर सूचना पर HMAC-SHA256 हस्ताक्षर होता है और आपका सर्वर जवाब न दे तो दोबारा कोशिश होती है। इवेंट:
task.createdtask.updatedtask.completedproject.createdproject.updatedproject.completednote.creatednote.updatednote.archivedreminder.createdreminder.updatedreminder.completedfollow_up.createdfollow_up.updatedfollow_up.closed